Every business of a kind in a city, from Google Maps, read from its website, with verified emails.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
FREE and exact. Counts leads THIS ACCOUNT has already searched and saved, matching any combination of filters, with a breakdown of how many are enriched, have an email, have a contact email, or have been relevance-checked. Use it to size a job over data the account already owns before spending: "how many of my saved roofers have no CRM and a verified email". CRITICAL: this is NOT an inventory of what Lyre Leads can find, and a small result here means the account has not searched much yet, nothing more. Never report this number to a user as the amount of data available, and never use it to answer "how many X do you have" — call estimate_list for that.
Substring match on city
Substring match on the Google Maps business category, e.g. "Dentist"
Substring match on the search keyword that found the lead, e.g. "roofing"
Substring match on country
true = a CMS was detected. false = enriched and none detected (custom/hand-built site).
true = a CRM was detected. false = enriched and none detected. This is the classic "they have no CRM, sell them one" filter.
true = enrolled in enrichment: re-checked about monthly at no charge. Every business a search found is enrolled. false = not enrolled (usually imported); enroll_leads enrolls it at one token per two businesses.
true = has a business email. false = enriched and confirmed to have none (excludes never-checked rows).
One of: yes, no, unclear. Did a model reading the business website judge it to be the kind of business this row's own search query asked for? Runs inside enrichment at no extra cost, and every verdict carries a verbatim quote from the page in relevance_evidence. Absent means never judged, which is not the same as "no". Filter on "yes" to drop the results Google Maps returned that are not the trade you searched for.
Restrict to one batch from search_leads
Maximum Google star rating. Use with min_reviews to find well-reviewed but poorly-rated businesses.
Minimum Google star rating
true = has a website. false = enriched and confirmed to have none.
Maximum Google review count
Minimum Google review count
One of: open, partial, blocked, unknown. "blocked" = the site is invisible to AI search engines.
One of: enriched, pending, unverifiable, no_website, failed
true = a named contact address is on file.
One of: verified, catch_all, unknown, invalid
FREE and exact. Counts leads THIS ACCOUNT has already searched and saved, matching any combination of filters, with a breakdown of how many are enriched, have an email, have a contact email, or have been relevance-checked. Use it to size a job over data the account already owns before spending: "how many of my saved roofers have no CRM and a verified email". CRITICAL: this is NOT an inventory of what Lyre Leads can find, and a small result here means the account has not searched much yet, nothing more. Never report this number to a user as the amount of data available, and never use it to answer "how many X do you have" — call estimate_list for that.
| Argument | Type | Description |
|---|---|---|
| city | string | Substring match on city |
| type | string | Substring match on the Google Maps business category, e.g. "Dentist" |
| query | string | Substring match on the search keyword that found the lead, e.g. "roofing" |
| country | string | Substring match on country |
| has_cms | boolean | true = a CMS was detected. false = enriched and none detected (custom/hand-built site). |
| has_crm | boolean | true = a CRM was detected. false = enriched and none detected. This is the classic "they have no CRM, sell them one" filter. |
| enrolled | boolean | true = enrolled in enrichment: re-checked about monthly at no charge. Every business a search found is enrolled. false = not enrolled (usually imported); enroll_leads enrolls it at one token per two businesses. |
| has_email | boolean | true = has a business email. false = enriched and confirmed to have none (excludes never-checked rows). |
| relevance | string | One of: yes, no, unclear. Did a model reading the business website judge it to be the kind of business this row's own search query asked for? Runs inside enrichment at no extra cost, and every verdict carries a verbatim quote from the page in relevance_evidence. Absent means never judged, which is not the same as "no". Filter on "yes" to drop the results Google Maps returned that are not the trade you searched for. |
| search_id | string | Restrict to one batch from search_leads |
| max_rating | number | Maximum Google star rating. Use with min_reviews to find well-reviewed but poorly-rated businesses. |
| min_rating | number | Minimum Google star rating |
| has_website | boolean | true = has a website. false = enriched and confirmed to have none. |
| max_reviews | integer | Maximum Google review count |
| min_reviews | integer | Minimum Google review count |
| ai_crawler_access | string | One of: open, partial, blocked, unknown. "blocked" = the site is invisible to AI search engines. |
| enrichment_status | string | One of: enriched, pending, unverifiable, no_website, failed |
| has_contact_email | boolean | true = a named contact address is on file. |
| email_verification_status | string | One of: verified, catch_all, unknown, invalid |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Substring match on city"
},
"type": {
"type": "string",
"description": "Substring match on the Google Maps business category, e.g. \"Dentist\""
},
"query": {
"type": "string",
"description": "Substring match on the search keyword that found the lead, e.g. \"roofing\""
},
"country": {
"type": "string",
"description": "Substring match on country"
},
"has_cms": {
"type": "boolean",
"description": "true = a CMS was detected. false = enriched and none detected (custom/hand-built site)."
},
"has_crm": {
"type": "boolean",
"description": "true = a CRM was detected. false = enriched and none detected. This is the classic \"they have no CRM, sell them one\" filter."
},
"enrolled": {
"type": "boolean",
"description": "true = enrolled in enrichment: re-checked about monthly at no charge. Every business a search found is enrolled. false = not enrolled (usually imported); enroll_leads enrolls it at one token per two businesses."
},
"has_email": {
"type": "boolean",
"description": "true = has a business email. false = enriched and confirmed to have none (excludes never-checked rows)."
},
"relevance": {
"type": "string",
"description": "One of: yes, no, unclear. Did a model reading the business website judge it to be the kind of business this row's own search query asked for? Runs inside enrichment at no extra cost, and every verdict carries a verbatim quote from the page in relevance_evidence. Absent means never judged, which is not the same as \"no\". Filter on \"yes\" to drop the results Google Maps returned that are not the trade you searched for."
},
"search_id": {
"type": "string",
"description": "Restrict to one batch from search_leads"
},
"max_rating": {
"type": "number",
"description": "Maximum Google star rating. Use with min_reviews to find well-reviewed but poorly-rated businesses."
},
"min_rating": {
"type": "number",
"description": "Minimum Google star rating"
},
"has_website": {
"type": "boolean",
"description": "true = has a website. false = enriched and confirmed to have none."
},
"max_reviews": {
"type": "integer",
"description": "Maximum Google review count"
},
"min_reviews": {
"type": "integer",
"description": "Minimum Google review count"
},
"ai_crawler_access": {
"type": "string",
"description": "One of: open, partial, blocked, unknown. \"blocked\" = the site is invisible to AI search engines."
},
"enrichment_status": {
"type": "string",
"description": "One of: enriched, pending, unverifiable, no_website, failed"
},
"has_contact_email": {
"type": "boolean",
"description": "true = a named contact address is on file."
},
"email_verification_status": {
"type": "string",
"description": "One of: verified, catch_all, unknown, invalid"
}
}
}Fetch each lead's website and extract 50+ fields: business email, social profiles, CMS, CRM, email-marketing platform, chat widget, booking system, ad pixels, analytics, schema, SSL, page load, domain age, mail host, and AI-crawler policy. Costs one token per five businesses, on any business you hold, and does not enroll it. Every address it finds is verified at no extra charge. To keep businesses current, use enroll_leads instead. Runs in the background, returns a job id, poll it with get_job_status. Every field follows the three-state contract: a value, a confirmed absence, or unknown.
| Argument | Type | Description |
|---|---|---|
| force | boolean | Re-enrich rows that already have data (use to refresh stale enrichment). Default false. |
| result_ids* | array | Lead ids from list_results |
{
"type": "object",
"required": [
"result_ids"
],
"properties": {
"force": {
"type": "boolean",
"description": "Re-enrich rows that already have data (use to refresh stale enrichment). Default false."
},
"result_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Lead ids from list_results"
}
}
}Enroll leads in enrichment so they stay current: each lead is enriched now and re-checked about once a month for as long as the user keeps it, with change signals when something moves. Costs one token per two businesses, paid once. Businesses a search found are already enrolled for free; already-enrolled leads and leads without a website are skipped at no cost. Use it for the imported or chosen leads the user cares about most. Runs in the background and returns a job id: poll get_job_status with kind "enrich".
| Argument | Type | Description |
|---|---|---|
| result_ids* | array | Lead ids to enroll |
{
"type": "object",
"required": [
"result_ids"
],
"properties": {
"result_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Lead ids to enroll"
}
}
}FREE, no account needed. Size a search_areas run before starting it: how many grid points, and, when the user's account is connected, how many areas it already covers for the query (those are skipped). It cannot give an exact cost, because billing is 1 token per NEW business found (one new lead costs one token) and nobody knows how many exist before looking.
| Argument | Type | Description |
|---|---|---|
| mode | string | grid covers the whole area (default here); city pages from the centre and is cheaper for small towns |
| areas* | array | Area names like "Houston, Texas", or ids from find_areas |
| query* | string | Business keyword, e.g. "roofing contractor" |
| country* | string | Country name, as listed by find_areas |
{
"type": "object",
"required": [
"query",
"country",
"areas"
],
"properties": {
"mode": {
"enum": [
"grid",
"city"
],
"type": "string",
"description": "grid covers the whole area (default here); city pages from the centre and is cheaper for small towns"
},
"areas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Area names like \"Houston, Texas\", or ids from find_areas"
},
"query": {
"type": "string",
"description": "Business keyword, e.g. \"roofing contractor\""
},
"country": {
"type": "string",
"description": "Country name, as listed by find_areas"
}
}
}FREE, no account needed. Answers "what would it cost to find me N businesses, and what data comes with each one". Returns an exact cost in tokens broken down by stage (search, enrichment, contact discovery; one new lead costs one token), and when the user's account is connected its balance and the maximum businesses affordable right now, and the full list of data points each lead arrives with. THIS is the tool to use when a user asks what Lyre Leads can get them. Do NOT use count_saved_leads for that question: Lyre Leads generates leads on demand from a live Google Maps search and does not sell access to a stored pile of them, so a count of what an account already holds is not a measure of what is available.
| Argument | Type | Description |
|---|---|---|
| lead_count* | integer | How many businesses the user wants found (1-100000) |
| include_contacts | boolean | Also find the named contacts at each business on the open web and verify their mailboxes. Default false. 2 tokens per person found, verification included. |
{
"type": "object",
"required": [
"lead_count"
],
"properties": {
"lead_count": {
"type": "integer",
"description": "How many businesses the user wants found (1-100000)"
},
"include_contacts": {
"type": "boolean",
"description": "Also find the named contacts at each business on the open web and verify their mailboxes. Default false. 2 tokens per person found, verification included."
}
}
}FREE, no account needed. Look up the areas search_areas accepts in a country, most populous first, each with an id. Call without q to browse; call with no country to get the list of countries. When a place name is shared (the US list has four Houstons and thirteen Springfields), pass the id of the one the user means to search_areas.
| Argument | Type | Description |
|---|---|---|
| q | string | Part of a place name, case-insensitive, e.g. "hous" |
| limit | integer | Max areas (default 20, max 100) |
| country | string | Country name, e.g. "United States". Omit to list countries. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Part of a place name, case-insensitive, e.g. \"hous\""
},
"limit": {
"type": "integer",
"description": "Max areas (default 20, max 100)"
},
"country": {
"type": "string",
"description": "Country name, e.g. \"United States\". Omit to list countries."
}
}
}For leads with a website but no named contact, search the open web for the people the business names (owner, founder, director), then resolve and verify their email in the same run. Costs 2 tokens per person found, verification included; the run reserves 2 tokens per business up front and settles on what it delivered, so the most a run can cost is 2 tokens per lead id sent. Separate from enrichment, which already lists the people a business's own site names, with a verified email where one exists, at no extra charge. This is what reaches local business owners who are not in any LinkedIn-derived contact database. Returns a job id, poll with get_job_status. Outcomes per lead: verified (SMTP-confirmed), published (the address is printed on the company's own site but the domain is catch-all so SMTP cannot confirm it), catch_all (person named, no address obtainable), or searched (no name found).
| Argument | Type | Description |
|---|---|---|
| result_ids* | array | Lead ids to search. Only leads with a website and no personal email yet are eligible; ineligible ids are skipped and not charged. |
{
"type": "object",
"required": [
"result_ids"
],
"properties": {
"result_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Lead ids to search. Only leads with a website and no personal email yet are eligible; ineligible ids are skipped and not charged."
}
}
}Get the account's token balance and plan. Plans are sold in leads and every price is in tokens: one new lead (a business found by a search, with enrichment, relevance check, verified address and the monthly re-check included) costs one token. Businesses the account already holds: enrichment is one token per five, enrolling in the monthly re-check one token per two. A named contact found on the open web costs 2 tokens, charged only when a person is found. Email verification is included at no charge. Unused tokens roll over, up to three months' allowance. Plans are bought and changed on the Lyre Leads website, not through these tools; the result carries the link.
No arguments.
{
"type": "object",
"properties": {}
}Poll a background job started by search_areas, enrich_leads, enroll_leads (kind "enrich"), find_contacts or verify_emails. Pass the job id and its kind. Long jobs are normal: a grid search works through many map points, and enrichment fetches every website in the batch.
| Argument | Type | Description |
|---|---|---|
| kind* | string | Which tool started it: search (search_areas), enrich (enrich_leads, enroll_leads), contacts (find_contacts), verify (verify_emails) |
| job_id* | string | Job id returned by the starting tool |
{
"type": "object",
"required": [
"job_id",
"kind"
],
"properties": {
"kind": {
"enum": [
"search",
"enrich",
"contacts",
"verify",
"decision_makers"
],
"type": "string",
"description": "Which tool started it: search (search_areas), enrich (enrich_leads, enroll_leads), contacts (find_contacts), verify (verify_emails)"
},
"job_id": {
"type": "string",
"description": "Job id returned by the starting tool"
}
}
}FREE. Read the leads a search_areas job found, up to 100 per page. Accepts the same filters as the Lyre Leads database, passed as filters, e.g. {"relevanceYes": true, "hasVerifiedEmail": true, "noFBPixel": true}. Each lead comes back compact by default: contact details, business email and its verification state, named contact, relevance verdict with its evidence, software and signals, plus a summary and next steps; detail "full" returns every database field. The summary counts every lead in the search (or every lead the filters match), not only the page, so one read answers how many have emails, contacts or no contact yet; read further pages only when the user asks to see more leads. Enrichment keeps landing for a while after the search finishes, so re-read if leads are still enriching.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 |
| limit | integer | Leads per page (default 50, max 100) |
| detail | string | compact (default) or full (every field, much longer) |
| job_id* | string | job_id returned by search_areas |
| filters | object | Database filter parameters as key/value pairs, e.g. {"relevanceYes": true, "minReviews": 100} |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"page": {
"type": "integer",
"description": "Page number, from 1"
},
"limit": {
"type": "integer",
"description": "Leads per page (default 50, max 100)"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "compact (default) or full (every field, much longer)"
},
"job_id": {
"type": "string",
"description": "job_id returned by search_areas"
},
"filters": {
"type": "object",
"description": "Database filter parameters as key/value pairs, e.g. {\"relevanceYes\": true, \"minReviews\": 100}"
}
}
}FREE. Read saved leads with what enrichment found: business email and its verification state, named contact (name, title, email and its state), the relevance verdict with the sentence from the business's own site, software (CMS, CRM, booking, chat, email marketing), technologies and signals. Pass the search_id from search_leads to read that search; wait_seconds (up to 45) first waits for enrichment still running on it. Returns a compact view with a summary and next steps; with a search_id the summary counts the whole search, not only the page. detail "full" returns every field.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max rows to return (default 50, max 100) |
| detail | string | compact (default) or full (every field, much longer) |
| offset | integer | Pagination offset |
| search_id | string | Batch id returned by search_leads (optional: omit for all results) |
| wait_seconds | integer | With search_id: wait up to this many seconds for enrichment to finish before reading. 40 right after search_leads. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Max rows to return (default 50, max 100)"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "compact (default) or full (every field, much longer)"
},
"offset": {
"type": "integer",
"description": "Pagination offset"
},
"search_id": {
"type": "string",
"description": "Batch id returned by search_leads (optional: omit for all results)"
},
"wait_seconds": {
"type": "integer",
"maximum": 45,
"minimum": 0,
"description": "With search_id: wait up to this many seconds for enrichment to finish before reading. 40 right after search_leads."
}
}
}FREE sample, no account: the first page (up to 20) of ONE Google Maps search for a kind of business in a place, with phones partly hidden. Nothing is saved or enriched, and it returns no emails, contacts or software. Use it only when the user asks for a preview or a sample, or has no account connected and wants to see what comes back. When the user asks to search, find, pull or list businesses, use search_leads (one city, answered at once) or search_areas (whole cities) instead, even for a single page: they save the businesses to the user's account and enrich them, and calling one starts sign-in if the account isn't connected yet. Places look like "Houston, TX", "Copenhagen" or "Lyon, France"; a shared name picks the largest and lists the others.
| Argument | Type | Description |
|---|---|---|
| place* | string | City or town, optionally with state and country, e.g. "Houston, TX" or "Aarhus, Denmark" |
| query* | string | Kind of business, e.g. "roofing contractor" or "hair salon" |
| country | string | Optional country name, if the place name alone is ambiguous across countries |
{
"type": "object",
"required": [
"query",
"place"
],
"properties": {
"place": {
"type": "string",
"description": "City or town, optionally with state and country, e.g. \"Houston, TX\" or \"Aarhus, Denmark\""
},
"query": {
"type": "string",
"description": "Kind of business, e.g. \"roofing contractor\" or \"hair salon\""
},
"country": {
"type": "string",
"description": "Optional country name, if the place name alone is ambiguous across countries"
}
}
}The search to use for coverage. Sweeps each area with a grid of map points live against Google Maps, as a background job, the same search the Lyre Leads Search page runs. In Houston this found 1,061 roofing contractors where paging from one centre found 255. Costs 1 token per NEW business (one new lead costs one token); listings the account already holds cost nothing (a small per-page minimum applies). Every new business is enriched, relevance-checked, its address verified, and enrolled in the monthly re-check automatically. Returns job_id: poll get_job_status with kind "search" until finished is true, then read the leads with get_search_results. If an area name fits more than one place, the call returns the candidates with ids and starts nothing: ask the user which one they mean and resend with that id. At most two searches run at once per account.
| Argument | Type | Description |
|---|---|---|
| mode | string | grid (default here) covers the whole area; city pages from the centre |
| areas* | array | Area names like "Houston, Texas", or ids from find_areas |
| query* | string | Business keyword, e.g. "roofing contractor" or "cosmetic dentist" |
| country* | string | Country name, as listed by find_areas |
{
"type": "object",
"required": [
"query",
"country",
"areas"
],
"properties": {
"mode": {
"enum": [
"grid",
"city"
],
"type": "string",
"description": "grid (default here) covers the whole area; city pages from the centre"
},
"areas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Area names like \"Houston, Texas\", or ids from find_areas"
},
"query": {
"type": "string",
"description": "Business keyword, e.g. \"roofing contractor\" or \"cosmetic dentist\""
},
"country": {
"type": "string",
"description": "Country name, as listed by find_areas"
}
}
}Search ONE city on the user's account and get the businesses back in the same call: 1 to 5 result pages from the city centre, about 20 per page. Use it when the user asks for a quick search, a page of results or one town; for a whole city or several, use search_areas, which finds several times more. Costs 1 token per NEW business (one new lead costs one token); ones the account already holds are free. Every new business is then enriched from its own website in the background, about two minutes for 20: business email with its verification state, a named contact where the site names one, the software it runs, and a check that it really is the kind of business searched for. Returns the Maps listing and a search_id. Then call list_results with that search_id and wait_seconds 40, and show the user what enrichment found, not only the listing.
| Argument | Type | Description |
|---|---|---|
| city* | string | City name, e.g. "Austin" |
| pages | integer | Result pages to pull, 1-5 (about 20 results per page). Default 1. |
| query* | string | Business keyword, e.g. "roofing contractor" or "cosmetic dentist" (max 200 chars) |
| country* | string | Country name, e.g. "United States" |
{
"type": "object",
"required": [
"query",
"city",
"country"
],
"properties": {
"city": {
"type": "string",
"description": "City name, e.g. \"Austin\""
},
"pages": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Result pages to pull, 1-5 (about 20 results per page). Default 1."
},
"query": {
"type": "string",
"description": "Business keyword, e.g. \"roofing contractor\" or \"cosmetic dentist\" (max 200 chars)"
},
"country": {
"type": "string",
"description": "Country name, e.g. \"United States\""
}
}
}SMTP-verify the business emails on saved leads through MillionVerifier. Included in every plan at no charge; a re-check within 90 days reuses the cached verdict. Runs in the background and returns a job id: poll get_job_status with kind "verify" until status is completed, then read the summary. Each address ends in one of four honest states: verified, catch_all (the domain accepts everything, so deliverability cannot be proven), unknown, or invalid. Never treat catch_all as verified.
| Argument | Type | Description |
|---|---|---|
| result_ids* | array | Lead ids to verify (max 2,000 per call) |
{
"type": "object",
"required": [
"result_ids"
],
"properties": {
"result_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Lead ids to verify (max 2,000 per call)"
}
}
}