# MCP server setup for Claude and Cursor · Leadraft

URL: https://leadraft.co/docs/mcp
Summary: Connect Leadraft to any MCP client over streamable HTTP with an API key. Start Google Maps searches, follow them and read verified leads from your assistant.

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 `Authorization` header, the same keys as the REST API (Settings → API keys). Use a `read`\-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_search`needs 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.

<table><tbody><tr><td class="whitespace-nowrap"><code>queries</code></td><td class="whitespace-nowrap">string[]</td><td>"keyword in location" lines.</td></tr><tr><td class="whitespace-nowrap"><code>email_required</code></td><td class="whitespace-nowrap">boolean = true</td><td>Only count businesses with an email.</td></tr><tr><td class="whitespace-nowrap"><code>region</code></td><td class="whitespace-nowrap">string?</td><td>Two-letter country code for ambiguous place names.</td></tr></tbody></table>

### `search_status`

A search's progress: running, finishing, paused or completed; searches done of the total; businesses and emails found so far.

<table><tbody><tr><td class="whitespace-nowrap"><code>group</code></td><td class="whitespace-nowrap">string</td><td>From start_search.</td></tr></tbody></table>

### `find_leads`

Businesses your searches found and count, newest first, each with its best sendable email. Up to 200 per call.

<table><tbody><tr><td class="whitespace-nowrap"><code>search_group</code></td><td class="whitespace-nowrap">string?</td><td>Only one search's leads.</td></tr><tr><td class="whitespace-nowrap"><code>keyword / text / category</code></td><td class="whitespace-nowrap">string?</td><td>The keyword that found it, free text over name and address, Maps category.</td></tr><tr><td class="whitespace-nowrap"><code>city / state / country</code></td><td class="whitespace-nowrap">string?</td><td>Location filters (country is a two-letter code).</td></tr><tr><td class="whitespace-nowrap"><code>has_email</code></td><td class="whitespace-nowrap">boolean?</td><td>With or without a sendable email.</td></tr><tr><td class="whitespace-nowrap"><code>grades</code></td><td class="whitespace-nowrap">string[]?</td><td>valid, catch_all, risky, unknown.</td></tr><tr><td class="whitespace-nowrap"><code>min_rating</code></td><td class="whitespace-nowrap">number?</td><td>Minimum Google rating.</td></tr><tr><td class="whitespace-nowrap"><code>cursor / limit</code></td><td class="whitespace-nowrap">integer?</td><td>Pass <code>next</code> back as <code>cursor</code>; limit defaults to 50, max 200.</td></tr></tbody></table>

### `get_lead`

One business: address, phone, website, hours, every email with its grade and source, and which searches found it.

<table><tbody><tr><td class="whitespace-nowrap"><code>lead_id</code></td><td class="whitespace-nowrap">integer</td><td>A lead's <code>id</code>.</td></tr></tbody></table>

### `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: …”

## Related pages

-   [REST API referenceThe same operations over HTTP](https://leadraft.co/docs/api)
-   [Quickstart](https://leadraft.co/docs/quickstart)

Last built: 2026-11-09