Log inSubmit server
B2bleads MCP logo

B2bleads MCP

Searches and enriches B2B companies by location, industry, ratings, websites, and saved lead lists through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install B2bleads MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "b2bleads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "b2bleads-mcp"
      ],
      "env": {
        "B2BLEADS_API_KEY": "YOUR_VALUE_HERE",
        "B2BLEADS_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 10 tools correctly (10d ago).

Overview

The b2bleads-mcp MCP server connects MCP-compatible clients to the B2BLeads REST API for real-time company and contact discovery. It provides filtered lead searches, city-wide expanded searches, industry lookup, saved-list access, and best-effort email finding for individual websites. Run it with Node.js 18 or later through npx and provide a B2BLeads API key. Use it when an agent needs location-based B2B prospecting or lead-list enrichment.

Use cases

  • Find companies by industry and city
  • Filter prospects by rating and website availability
  • Expand searches across an entire city
  • Save search results into reusable lead lists
  • Look up an email for a specific business website

Key features

  • Real-time B2B company and contact search
  • Industry and location filtering
  • Expanded 3-by-3 city searches
  • Saved lead-list management
  • Best-effort website email lookup
  • Pagination for standard searches

Tools10

What B2bleads MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

10/10 checks healthy over the last 45d

What it can do

From the 10 tools this server returned when we ran it.

Makes network requests · 1Read-only tools · 10
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age39 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · b2bleads-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.4kPackage downloads in the last 30 days.
Last commit29d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed10Callable tools this server registers over MCP.

How B2bleads MCP works

What b2bleads-mcp MCP server does

The b2bleads-mcp MCP server exposes the B2BLeads REST API as tools for MCP-compatible agents. It searches for companies and business contacts using free-text queries, industries, cities or regions, distance, ratings, business status, pricing, websites, verification, language, and result ordering. Search results can include company name, address, phone, website, rating, and email when available.

The standard search accepts at least one of a free-text query, industry, or city. Results can be limited to 1–20 records per call and continued with a pagination token. Searches can also append results to an existing saved list or create/find a list by name.

How it works

The package runs as a local MCP process and sends requests to B2BLeads. An agent invokes the available tools, while the server handles communication with the API and returns the API response or an error such as a quota or rate-limit failure.

For larger city searches, search_leads_advanced divides a city into a 3-by-3 grid of sub-searches and returns up to approximately 180 deduplicated businesses. This operation costs nine times the quota of one regular search, does not provide pagination, and should be reserved for cases where the normal search does not return enough results or exhaustive city coverage is needed. Its city value should contain only the city or region name.

Saved-list tools let an agent first retrieve list IDs, names, and counts, then fetch the complete leads for one selected list. find_email checks a supplied business website, including its homepage and common contact pages, for a possible contact email.

Setup and configuration

The b2bleads-mcp MCP server requires Node.js 18 or newer, a B2BLeads account, and an API key. It can be launched without a local package installation using:

Terminal
npx -y b2bleads-mcp

Configure the MCP client to run that command and set B2BLEADS_API_KEY in its environment. The key is created in the B2BLeads dashboard after choosing a plan. B2BLEADS_API_URL is optional and can replace the default API base URL, https://api.b2bleadsapi.com.

The documented configuration works with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients. In Cursor, the same server definition can be placed in project or global MCP settings. Claude Desktop uses its MCP configuration file, while Claude Code can add the server through its MCP command.

Tools and capabilities

  • search_leads: Runs a real-time search with geographic, industry, rating, business-status, website, verification, price, language, ranking, pagination, and saved-list options.
  • search_leads_advanced: Expands a city search across nine geographic areas for broader coverage, with the elevated quota cost described above.
  • list_industries: Returns the predefined categories accepted by the regular search's industry filter.
  • list_saved_lists: Returns saved-list IDs, names, and lead counts without returning the leads themselves.
  • get_saved_list: Retrieves all saved leads for a specified list ID.
  • find_email: Performs a best-effort lookup for one website and may return no email. This requires a paid B2BLeads plan, starting with Starter.

Limitations and notes

The b2bleads-mcp MCP server depends on an active B2BLeads account, plan, API key, quota, and rate limits. Search quota is consumed by each search, and API quota or rate-limit errors are surfaced as tool errors. The advanced search is not a general replacement for the regular search because it costs nine times as much and cannot paginate.

Email discovery is not guaranteed: find_email may return null when no address is found. It is intended for one website at a time rather than repeating a broad lead search. The advanced tool also requires a city value and can produce incorrect geocoding if the input includes a complete search phrase instead of only the place name.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about B2bleads MCP

b2bleads-mcp is an MCP server that connects AI agents to the B2BLeads REST API. Its main tools search and enrich B2B companies, expand searches across a city, list industries, manage saved lead lists, and find a best-effort contact email for one business website.

Run it through npx rather than installing it locally. Configure your MCP client to execute `npx -y b2bleads-mcp`, use Node.js 18 or newer, and set the `B2BLEADS_API_KEY` environment variable to an API key from your B2BLeads account.

Yes, b2bleads-mcp works with Cursor. Add the MCP server configuration to the project's `.cursor/mcp.json` file or to Cursor's global MCP settings, using the npx command and your `B2BLEADS_API_KEY`.

Use `search_leads_advanced` with the city name and optional query or industry filters. It searches a 3-by-3 geographic grid and can return approximately 180 deduplicated businesses, but it costs nine times the quota of a regular search and does not support pagination.

Yes, use `find_email` with one business website URL. The tool checks the homepage and common contact pages, but the result is best-effort and may be null. It requires a paid B2BLeads plan starting with Starter.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewB2bleads MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/b2bleads-mcp?style=directory)](https://allmcps.com/mcp/b2bleads-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/b2bleads-mcp"><img src="https://allmcps.com/api/badge/b2bleads-mcp?style=directory" alt="B2bleads MCP on AllMCPs" /></a>