---
title: "B2B data MCP server for any MCP client | Leadsets"
description: "Connect Leadsets, a remote B2B data MCP server, to any MCP client at mcp.leadsets.ai. Eight tools for search, enrichment, verified emails and scraping."
canonical: https://www.leadsets.ai/integrations/mcp-clients
updated: 2026-11-09
---

# Use Leadsets as a B2B data MCP server in any MCP client

Leadsets is a remote B2B data MCP server at https://mcp.leadsets.ai. Any MCP client can add that URL and get eight tools: search_people, search_companies, enrich_person, enrich_company, verify_email, scrape_company, scrape_jobs and get_usage. Nothing is installed. Plans are flat monthly from $29, with 1,000 free records to start. Leadsets has no phone numbers yet and is not a CRM or sending tool.

## What an agent can do with Leadsets over MCP

An MCP client is an application that connects to MCP servers so an AI model can call their tools.

Leadsets is a remote MCP server, listed on the integrations page as **Remote MCP** for any MCP client. Once the client is connected, the agent can call eight tools and get back structured JSON with match reasons, verification status, confidence and the date each field was last checked.

| Tool | What it returns | Uses |
| --- | --- | --- |
| `search_people` | People by title, function, seniority, location, company size and industry, with match reasons | 1 search record per record returned |
| `search_companies` | Accounts by industry, headcount band, technology and location | 1 search record per record returned |
| `enrich_person` | Current role, company and a verified work email when one exists | 1 enrichment record per record returned |
| `enrich_company` | Firmographics for a domain, with source and freshness per field | 1 enrichment record per record returned |
| `verify_email` | Verified, catch-all, unknown or invalid, with a confidence score | Counts toward enrichment |
| `scrape_company` | A homepage turned into products, positioning, customers named and key links | 1 scrape unit per page |
| `scrape_jobs` | Open roles from careers pages, with titles and dates | 1 scrape unit per page |
| `get_usage` | Every meter and reset time | Nothing |

The user describes their customer in plain language, for example "RevOps leads at 50 to 200 person fintechs", and the agent turns it into filters and picks the tools. The full tool reference is on the [AI agents page](https://www.leadsets.ai/agents).

## How to connect Leadsets to an MCP client

The Leadsets docs give step-by-step instructions for Claude, Claude Code and Cursor. For other MCP clients, the site says only to add the remote server URL, so follow your client's own instructions for adding a remote MCP server. This page does not describe menus or settings inside any particular client.

1. **Get an account.** Create a free Leadsets account: 1,000 records, one time, no card. If your client needs a key, copy it from the dashboard. Keys start with `ls_live_` and should be kept server-side.
2. **Add the server URL.** The MCP server is `https://mcp.leadsets.ai`. It is remote, so there is nothing to install or run locally.
3. **Authenticate.** The docs show two patterns. In Claude on the web and desktop, the connector signs in with OAuth and there is no key to paste. In Cursor, the server entry carries an `Authorization` header with your bearer key, in this format:

```
{
  "mcpServers": {
    "leadsets": {
      "url": "https://mcp.leadsets.ai",
      "headers": { "Authorization": "Bearer ls_live_…" }
    }
  }
}
```

   In Claude Code the documented command is:

```
claude mcp add --transport http leadsets \
  https://mcp.leadsets.ai
```

4. **Check it works.** Ask the agent "What's my Leadsets usage?" If it calls `get_usage` and answers with your remaining balance, you are connected.
5. **Add skills (optional).** Leadsets publishes 50 free, MIT-licensed SKILL.md playbooks for any agent that reads the SKILL.md standard. Clone them with `git clone github.com/leadsets/leadsets-skills`, or browse the [skills library](https://www.leadsets.ai/skills).
6. **Fall back to REST if needed.** If a client or workflow cannot use MCP, every tool is also a REST endpoint at `https://api.leadsets.ai/v1` with a bearer key, plus TypeScript and Python SDKs. Results can be exported as CSV for any sequencer.

Client-specific detail for Claude, Claude Code and Cursor is in [Connect via MCP](https://www.leadsets.ai/docs/mcp).

## Example: a hiring-signal list for Northwind Analytics

Maya Chen runs revenue operations at Northwind Analytics (northwind.co). She connects Leadsets to her MCP client and asks:

> "Find US B2B SaaS companies with 20 to 200 people that are hiring SDRs. Get their revenue leaders with verified work emails and give me a CSV."

A typical run, as the Leadsets site describes it:

1. `get_usage` checks what is left in the current five-hour window and week, at no cost.
2. `search_companies` finds matching accounts, such as Stackfold or Parcelry.
3. `scrape_jobs` reads their careers pages to confirm open SDR roles. This uses scrape units, which are an add-on on paid plans and not available on Free.
4. `search_people` finds VP-level revenue leaders at the confirmed accounts, with match reasons.
5. `enrich_person` returns verified work emails where they exist, and `verify_email` checks any addresses Maya already had.
6. The agent returns a table with catch-all addresses in a separate segment and exports a CSV for her sequencer.

The free Build an outbound prospect list skill follows a similar order: confirm the ICP, check limits, probe with a one-record search, then search, enrich and verify.

## What to watch for: records, limits and email labels

- **Records vs requests.** A record counts only when data comes back, so an empty search uses none. Every call counts as a request, hit or miss. The request limit is five times the record allowance.
- **Rolling windows.** Search and enrichment each have a five-hour window and a weekly limit. Solo ($29 a month) allows 500 search records and 1,000 enrichments per five hours; Pro ($99) allows 7,500 and 15,000. Team ($399) and Max ($999) go higher. Concurrent searches are 3, 5, 8 and 8.
- **Limit errors.** Over a limit, the server returns 429 with a Retry-After time and the blocked call counts against nothing. When the free records run out, the error is 402 `free_records_exhausted`, and the agent should ask you to upgrade rather than retry. Details are in [limits and costs](https://www.leadsets.ai/docs/limits).
- **Email labels.** Verified means the mailbox accepts mail. Catch-all means the domain accepts everything, so send at lower volume. Unknown means no clear answer, so treat it as unconfirmed. Invalid addresses are never served as contact emails. See [what a catch-all email is](https://www.leadsets.ai/answers/what-is-a-catch-all-email).
- **Verification cost.** Emails from `enrich_person` are already verified with no second charge. Standalone `verify_email` counts toward the enrichment limit.

## What this integration does not do

- **No phone numbers.** Leadsets returns work emails, US personal emails on paid plans, roles and company data. If phone numbers are essential, another provider is a better fit today.
- **Not a CRM or a sending tool.** Leadsets feeds your CRM and sequencer through skills, the API and CSV; it does not send email.
- **Business data only.** No consumer data, sensitive categories or personal home addresses.
- **No scraping behind logins.** Scraping reads public company pages only and is not on the Free plan.
- **SOC 2 is planned, not done.** SOC 2 Type I readiness is underway with a target of Q3 2027. Teams that need a SOC 2 report today should factor that in.
- **Outreach compliance is yours.** You are responsible for following laws such as CAN-SPAM, GDPR and CASL and honouring unsubscribes.

## Questions and answers

### What is a B2B data MCP server?

A B2B data MCP server exposes tools an AI agent can call to search people and companies, enrich contacts and verify emails on its own. Leadsets is a remote MCP server at https://mcp.leadsets.ai with eight tools, so nothing is installed or run locally.

### How do I add Leadsets to an MCP client that is not Claude or Cursor?

Add the remote server URL https://mcp.leadsets.ai using your client's own method for adding a remote MCP server. The Leadsets docs give specific steps only for Claude, Claude Code and Cursor, showing either OAuth sign-in or an Authorization header with a bearer key that starts with ls_live_.

### How do I check that the Leadsets MCP server is connected?

Ask your agent "What's my Leadsets usage?" If it calls get_usage and answers with your remaining balance, you are connected. get_usage costs nothing to call.

### Which tools does the Leadsets MCP server include?

Eight: search_people, search_companies, enrich_person, enrich_company, verify_email, scrape_company, scrape_jobs and get_usage. scrape_company and scrape_jobs use scrape units, an add-on on paid plans, and are not available on Free.

### Can I use Leadsets if my tool does not support MCP?

Yes. Every tool is also a REST endpoint at https://api.leadsets.ai/v1 with a bearer key, plus TypeScript and Python SDKs. Results can also be exported as CSV for any sequencer.

### Does the Leadsets MCP server return phone numbers?

Not yet. Leadsets returns work emails, US personal emails on paid plans, roles and company data. It will only add phone numbers once sourcing rights and costs are clear.

---

Leadsets · https://www.leadsets.ai · Site index: https://www.leadsets.ai/llms.txt