Docs

LeadLists MCP server

Give Claude, ChatGPT, Cursor or your own agent the LeadLists tools. Ask for "dentists in Austin with the owner's email" in a chat and get the leads back in the same conversation.

Server URL

https://leadlists.app/mcp
Streamable HTTP. JSON-RPC 2.0, protocol versions 2024-11-05 to 2025-11-25.

Step-by-step setup for Claude, ChatGPT, Cursor, Windsurf, Gemini CLI and n8n is in the MCP section on the homepage. The short versions:

claude mcp add --transport http leadlists https://leadlists.app/mcp
Claude Code
gemini mcp add --transport http leadlists https://leadlists.app/mcp
Gemini CLI
{
  "mcpServers": {
    "leadlists": { "url": "https://leadlists.app/mcp" }
  }
}
Cursor (mcp.json)
POST https://leadlists.app/mcp
Authorization: Bearer ll_your_api_key
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Any client with an API key

Sign-in

Clients that support OAuth open a LeadLists sign-in and consent screen the first time they connect. The server supports OAuth 2.1 with dynamic client registration and PKCE, and advertises itself through protected resource metadata. Clients without OAuth send an API key from Settings, then API as Authorization: Bearer ll_…. The full flow is in auth.md.

The MCP server is included on the Bespoke Starter and Bespoke Pro plans. See pricing.

Lead tools

ToolWhat it does
find_leadsBuild a lead list from a plain request, such as "roofing contractors in Dallas, TX with under 20 reviews". Scans the area, then finds the owner, email and phone for each business. Returns the first leads and a list_id.
create_listScan and estimate without building. Returns the number of matches and how many are likely to have an email. Nothing is charged.
build_leadsStart building a list that has finished scanning, up to max_leads. Only businesses with an email are charged.
get_listStatus and progress of a list: scan results, the estimate and the current build.
get_leadsThe leads in a list: business, owner, email, phone, website, address, category, rating and reviews. Paginate with offset.
list_listsThe user's lists, newest first.
stop_listStop a scan or build. Leads already delivered are kept.
get_usageThe user's plan and how many leads are left this month.

The usual call is find_leads with one business type and one US city or area, then get_leads with the returned list_id until the build is done. Each lead with an email uses one lead from the monthly allowance; businesses where no email is found are free.

Data tools

The same live sources the LeadLists agent uses are available as tools: google_maps_search, google_places_search, google_reviews, google_search, fetch_page, yelp_search, yelp_place, linkedin_company, linkedin_jobs, indeed_search, google_jobs, facebook_search_pages, instagram_profile, google_news, reddit_search, zillow_search. Every other source (marketplaces, job boards, app stores, social profiles and more) is reached through list_data_sources and query_data_source.

Discovery files

Building against the REST API instead? See the LeadLists API docs. Stuck? Contact us.