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, 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

1. Create an account at b2bleadsapi.com.
2. Pick a plan in Billing.
3. Generate a key under API Keys in the dashboard.
4. 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.

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

search_leads_advanced

⚠️ Elevated cost: consumes 9x the quota of a single `search_leads` call. Only use this when you need more results than search_leads returned for a specific city, or need to exhaustively cover a city — not as a default or first attempt. Tiles the city into a 3x3 grid of sub-searches server-side to go beyond the normal ~20-60 result ceiling, returning up to ~180 deduplicated businesses in one call. Does not support pagination.

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 — id, name, and lead count for each, not the leads themselves. Read-only. Takes no arguments. Use get_saved_list to fetch one list's full leads.

get_saved_list

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

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 any paid plan (Starter and above); may return a null email if none is found.

account_get_usage

Gets how much of your monthly search quota has been used and how much remains for the current billing period. Read-only. Takes no arguments.

account_get_usage_limit

Gets your account's total monthly search quota and when the current billing period renews. Read-only. Takes no arguments.

list_saved_searches

Lists your saved search alerts (recurring searches that auto-run and save results to a list). Read-only. Takes no arguments.

get_search_history

Gets your recent search history — up to the last 200 searches (query text, result count, date). Read-only. Takes no arguments.

Configuration

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
• This package's integration page — setup notes specific to a plain Node.js MCP client
• Claude Desktop / Claude Code integration page
• Terms of Use
• Privacy Policy

License

MIT