# b2bsearch MCP server

> Enables AI clients to find B2B contacts, identify new hires, discover decision makers, and find lookalike companies using Apify actors.

- Repository: https://github.com/keyvwin/mcp
- Page: https://hostedmcp.org/servers/keyvwin/mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.3

## Install

### Claude Code

```sh
claude mcp add --env 'APIFY_TOKEN=<YOUR_APIFY_TOKEN>' mcp -- npx -y @b2bsearch/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@b2bsearch/mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@b2bsearch/mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@b2bsearch/mcp"],"env":{"APIFY_TOKEN":"<YOUR_APIFY_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@b2bsearch/mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'APIFY_TOKEN=<YOUR_APIFY_TOKEN>' --env 'APIFY_TOKEN=<YOUR_APIFY_TOKEN>' -- npx -y @b2bsearch/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@b2bsearch/mcp"]

[mcp_servers.mcp.env]
APIFY_TOKEN = "<YOUR_APIFY_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'APIFY_TOKEN=<YOUR_APIFY_TOKEN>' -e 'APIFY_TOKEN=<YOUR_APIFY_TOKEN>' mcp npx -- -y @b2bsearch/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@b2bsearch/mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APIFY_TOKEN` | yes | yes | Apify API token (Console → Settings → Integrations) |
| `APIFY_TOKEN` | yes | yes | Apify API token (Console → Settings → Integrations) |

## Tools (6)

- `find_new_hires`: Who recently joined the given companies: name, new title, start month, seniority, LinkedIn URL and the employer and title they came from. Use for job-change and hiring signals on an account list. Pay per new hire delivered ($3.20 per 1,000); companies with nobody new are free. Not for people who left (use former employees) and not for job postings.
- `company_email_format`: How a company writes work email addresses (first.last@, flast@, first@), derived from addresses on record for its current staff: pattern, confirmations, agreement, coverage, other patterns, masked samples. No address is returned. Use before guessing an address from a name. $0.02 per domain with a confirmed pattern; weak, unknown and shared-hosting domains are free.
- `find_lookalike_companies`: Similar companies for each seed domain: same industry, same country and similar headcount by default, each with name, domain, LinkedIn page, industry, headcount, HQ, founding year, last funding round and an explicit matchedOn string. Use to expand best customers into target accounts. $0.0015 per company delivered; the seed, duplicates and unresolved seeds are free. Not for company search by filters without a seed.
- `find_decision_makers`: Founders, C-level, VPs and directors at the given companies: name, title, seniority, LinkedIn URL and whether a work email is on record. Use after you have target domains. $3.20 per 1,000 people; companies with nobody matching are free. Emails are not included: pass linkedinUrl values to find_email_by_linkedin_url for the people you choose.
- `find_email_by_linkedin_url`: The email address on record for each LinkedIn profile URL or handle: best address, its type (work or personal), all work addresses, plus name, title and employer. Addresses are read from a database, not guessed and not scraped. $8 per 1,000 profiles with an address; profiles without one are free. Use for a list the user already has; for people search by criteria use search_people.
- `search_people`: Find people matching an ideal customer profile. mode "count" returns the number of matches for free; "market" adds a free breakdown by country, seniority, employer size, industry and title; "people" returns rows at $0.95 per 1,000 (name, title, seniority, employer, location, LinkedIn URL, email flags). Always count first, then ask the user before switching to "people". No live LinkedIn pages are read.

## FAQ

### How much does it cost to use the tools?

Pricing varies by tool, such as $3.20 per 1,000 new hires or $0.02 per domain for email formats. Every call includes a maxChargeUsd cap, defaulting to $5.

### Can I use this for free?

Yes, free Apify accounts can use the tools with limits of 500 rows per month per Actor and specific limits on rows per run. Certain search modes are also free.

### What information is returned for new hires?

The tool provides the person's full name, job title, seniority, company name, start date, previous company, previous title, and LinkedIn URL.
