b2bleads-mcp

B2BLeads MCP Server

An MCP (Model Context Protocol) server that gives AI agents — Claude, Cursor, and any other MCP-compatible client — a search_leads tool for real-time B2B company discovery and enrichment.

Ask your agent things like:

"Find construction companies in Munich with a website and phone number."

"Collect 50 IT companies in Berlin rated above 4.0."

"Enrich this lead list with email contacts where available."

...and it calls this tool to return a ready-made list of companies: name, address, phone, website, rating, and email where available.

This server is a thin MCP wrapper around the B2BLeads REST API. You need a B2BLeads account and API key — see Getting an API key below.

Requirements

• Node.js 18 or later
• A B2BLeads API key (sign up)

Installation

No install needed — run it directly with npx. Add it to your MCP client's config:

Claude Desktop / Claude Code

Edit your claude_desktop_config.json (or run claude mcp add):

{
  "mcpServers": {
    "b2bleads": {
      "command": "npx",
      "args": ["-y", "b2bleads-mcp"],
      "env": {
        "B2BLEADS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add the same block to .cursor/mcp.json in your project (or your global Cursor MCP settings).

Any other MCP client

Point it at the command npx -y b2bleads-mcp with the B2BLEADS_API_KEY environment variable set.

Getting an API key

• Create an account at b2bleadsapi.com.
• Pick a plan in Billing.
• Generate a key under API Keys in the dashboard.
• Set it as B2BLEADS_API_KEY in your MCP client config (see above).

Tools

search_leads

Search for companies and business contacts in real time.

Parameter	Type	Description
q	string	Free-text query, e.g. "construction companies in Munich".
industry	string	One of the categories from list_industries.
city	string	City or region to search in.
radius_km	number	Search radius in kilometers.
min_rating	number	Minimum rating (0-5).
has_website	boolean	Only businesses with a website.
verified_only	boolean	Only businesses with a verified listing.
open_now	boolean	Only businesses currently open.
price_level	string	budget | moderate | expensive | luxury
rank_by	string	relevance | distance
limit	integer	Max results per call, 1-20.
lang	string	Result language, BCP-47 tag (e.g. en, pt-BR).
page_token	string	Pagination token from a previous call.
save_to_list	boolean	Also save results into a B2BLeads saved list.
list_id	string	Existing saved-list ID to append to.
list_name	string	Saved-list name to find-or-create and append to.

At least one of q, industry, or city is required.

list_industries

Lists the predefined industry categories usable in search_leads's industry filter. Takes no arguments.

list_saved_lists

Lists all of your saved lead lists, each with its full set of saved leads. Read-only. Takes no arguments.

get_saved_list

Gets one saved lead list by ID, with its full set of saved leads. Read-only.

Parameter	Type	Description
list_id	string	The saved list's ID, from list_saved_lists or a search_leads save_to_list response. Required.

find_email

Looks up a best-effort contact email for a single business website (checks the homepage and common contact pages). Use this for one specific website rather than re-running search_leads. Requires a Business/Premium plan; may return a null email if none is found.

Parameter	Type	Description
website	string	The business website URL to look up, e.g. https://example.com. Required.

Configuration

Environment variable	Required	Description
B2BLEADS_API_KEY	Yes	Your B2BLeads API key.
B2BLEADS_API_URL	No	Override the API base URL. Defaults to https://api.b2bleadsapi.com.

Pricing & rate limits

Each search consumes quota from your B2BLeads plan — see pricing. Rate limits and quota errors are returned by the API and surfaced back to your agent as tool errors.

Links

• B2BLeads website
• REST API documentation
• Terms of Use
• Privacy Policy

License

MIT