@localleads/mcp

Stdio Model Context Protocol server for LocalLeads. Connects Claude Desktop, Cursor, VS Code, and other local MCP clients to the LocalLeads REST API so the model can search Google Maps for businesses, enrich contacts, and check your credit balance without leaving the chat.

Using Claude.ai (web)? Use the remote MCP connector at https://leadsapi.postorbit.io/mcp instead. It supports OAuth so claude.ai can connect with one click. See the docs for details.

Install

npm install -g @localleads/mcp
# or run on demand with npx (no install)
npx -y @localleads/mcp

Configure

You need a LocalLeads API key (starts with ll_). Generate one at Settings → Security → API Keys in your LocalLeads dashboard.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "localleads": {
      "command": "npx",
      "args": ["-y", "@localleads/mcp"],
      "env": {
        "LOCALLEADS_API_KEY": "ll_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. The LocalLeads tool icon (🔨) appears in the chat toolbar.

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "localleads": {
      "command": "npx",
      "args": ["-y", "@localleads/mcp"],
      "env": {
        "LOCALLEADS_API_KEY": "ll_your_key_here"
      }
    }
  }
}

Tools

| Name | Cost | What it does | |---|---|---| | search_leads | charges credits | Search Google Maps for businesses in a location. Returns a query ID. | | get_query_progress | free | Poll the status of an in-flight search. | | get_search_results | free | Retrieve leads from a completed search (compact by default). | | get_lead | free | Fetch one lead's full payload + enrichment by ID. | | list_all_leads | free | List every lead saved in the account, with filters (compact by default). | | enrich_leads | 1 credit per lead | Find verified business emails for one or more leads. | | get_enrichment_result | free | Get the email + confidence score for an enriched lead. | | verify_email | free | Verify an arbitrary email address (syntax + MX). | | list_enrichment_jobs | free | List in-flight search and enrichment jobs. | | check_credits | free | Return current credit balance. |

Environment variables

| Var | Required | Description | |---|---|---| | LOCALLEADS_API_KEY | yes | Your ll_… API key. | | LOCALLEADS_API_BASE | no | Override the API base URL. Defaults to https://leadsapi.postorbit.io. Must be https://. |

Maintainers

Publishing a new version? See PUBLISHING.md for the 2FA / token workflow.

License

MIT