Docs · Reference · Last updated October 31, 2026
MCP server
Ask your AI assistant for “dentists in Leeds with verified emails” and let it run the search. Leadraft speaks the Model Context Protocol, with the same reach and credits as the REST API.
Connect
- URL:
https://app.leadraft.co/api/mcp/ - Transport: streamable HTTP (stateless, JSON responses).
- Auth: an API key in the
Authorizationheader, the same keys as the REST API (Settings → API keys). Use aread-only key if the assistant should never start searches.
claude mcp add --transport http leadraft https://app.leadraft.co/api/mcp/ \
--header "Authorization: Bearer lg_your_key"Tools
Tool calls count against the key's rate limit (120 a minute) and spend credits exactly like the API.
start_searchneeds write access
Start finding businesses. Each query is a keyword and a location, like "plumber in Austin, TX". Returns the search's group and any lines that couldn't run. Uses business credits as businesses are found.
queries | string[] | "keyword in location" lines. |
email_required | boolean = true | Only count businesses with an email. |
region | string? | Two-letter country code for ambiguous place names. |
search_status
A search's progress: running, finishing, paused or completed; searches done of the total; businesses and emails found so far.
group | string | From start_search. |
find_leads
Businesses your searches found and count, newest first, each with its best sendable email. Up to 200 per call.
search_group | string? | Only one search's leads. |
keyword / text / category | string? | The keyword that found it, free text over name and address, Maps category. |
city / state / country | string? | Location filters (country is a two-letter code). |
has_email | boolean? | With or without a sendable email. |
grades | string[]? | valid, catch_all, risky, unknown. |
min_rating | number? | Minimum Google rating. |
cursor / limit | integer? | Pass next back as cursor; limit defaults to 50, max 200. |
get_lead
One business: address, phone, website, hours, every email with its grade and source, and which searches found it.
lead_id | integer | A lead's id. |
list_searches
Your last 100 searches, newest first, with status and counts.
credits
Your plan, this period's allowance and what's left: businesses and checked emails.
Prompts to try
- “How many business credits do I have left this month?”
- “Find roofers in Denver, CO with verified emails.”
- “Is my roofers search done yet? How many have an email?”
- “Show me the 20 best-rated dentists from that search, with their emails.”
- “Start a search for HVAC companies in every city in this list: …”