The Leadity MCP server. Google Maps leads from your AI agent.

The Leadity MCP server gives Claude, Cursor and any other MCP client the Leadity operations as tools: find niches, price an order, place it with a ceiling you agreed to, watch it run and hand you the leads.

On this page
  1. How do you connect an AI agent to Leadity?
  2. What does the setup look like?
  3. How do the Leadity MCP tools behave?
  4. What can an MCP key not do?
  5. Questions about the Leadity MCP server
  6. Related guides and pages
  7. When these MCP facts were read

How do you connect an AI agent to Leadity?

Create an MCP key

Open Connectors in your Leadity account, go to its MCP screen and create an MCP key. It starts with lk_mcp_ and works only on the MCP server.

Choose its scopes

read lets the agent explore and price orders. Add spend only if the agent may place them.

Add the server to your client

The server runs at https://mcp.leadity.io/mcp and speaks Streamable HTTP, so there is nothing to install.

Ask for leads

The agent prices the order first, tells you the cost, and buys only with a maxCredits no higher than what you agreed to.

What does the setup look like?

One command in Claude Code, a few lines of JSON in Cursor.

Claude Code. Run this in a terminal, with your own MCP key after Bearer:

claude mcp add --transport http leadity https://mcp.leadity.io/mcp \
  --header "Authorization: Bearer lk_mcp_..."

Add --scope user to use the server in every project.

Cursor. Add the server to your MCP settings:

{
  "mcpServers": {
    "leadity": {
      "url": "https://mcp.leadity.io/mcp",
      "headers": {
        "Authorization": "Bearer lk_mcp_..."
      }
    }
  }
}
  • url is the server's address, the same for every account.
  • Authorization carries your MCP key. An API key, which starts with lk_api_, is refused here.

Claude Desktop, VS Code and other clients are set up in the MCP setup guide.

How do the Leadity MCP tools behave?

Built so an agent cannot overspend.

Each tool says what it does to your balance. A tool that takes credits says so at the start of its description and names the free tool that prices it.

A retry does not buy twice. The server makes the idempotency key from the call itself, so a model that repeats a purchase with the same arguments inside the same ten-minute window gets the first answer back.

Nothing waits. Every tool answers at once, and after starting a scrape the agent polls get_scrape_status every 30 to 60 seconds until it is complete.

Files come back as links. A download tool answers a link that lives fifteen minutes and opens at most five times, never the file itself.

What can an MCP key not do?

A key cannot sign in, change the account's email or password, or delete the account, so a leaked key can never take the account. An account holds at most 5 live MCP keys, and an MCP key spends the same per-key and per-account rate limits as an API key.

Orders spend credits at the web app's rates, from $0.0032 a business record and $0.016 a carrier-verified mobile. See every rate on the pricing page.

Questions about the Leadity MCP server

Yes, Leadity has an MCP server at mcp.leadity.io/mcp. It gives any MCP client, such as Claude Code, Claude Desktop or Cursor, the same operations as the Leadity API, with an MCP key from the Connectors page of your account.

An AI agent can spend credits through the Leadity MCP server only if its key holds the spend scope. Every order carries a maxCredits ceiling, and a key with only read can explore and price orders but never buy one.

Any MCP client that supports remote servers works with the Leadity MCP server, because it speaks Streamable HTTP. The setup guide covers Claude Code, Claude Desktop, Cursor and VS Code.

An API key starts with lk_api_ and works only on the HTTP API, and an MCP key starts with lk_mcp_ and works only on the MCP server. Keeping them apart lets you revoke an agent's access without touching your scripts.

Related guides and pages

When these MCP facts were read

Facts as of 24 October 2026, from the Leadity MCP documentation at docs.leadity.io.

Connect your agent. Free to start.

Create a free account, open Connectors and create an MCP key.

Every new account gets 300 free credits, with no card. That is enough for 1,500 business records or 300 verified mobiles.