NewNew: push contacts to your CRM and use them from your AI assistant
Developers

MCP server

Let your AI assistant search BusinessContacts.io and reveal contacts for you. It works inside your own account: the same data, the same credits and the same limits as the workspace.

Connect

MCP (Model Context Protocol) is the standard way for AI assistants to use outside tools. There are two ways to connect, and both use the same server address.

Server address (Streamable HTTP)
https://www.businesscontacts.io/api/mcp

1. Sign in (no key needed)

Apps that support MCP sign-in, such as custom connectors in the Claude and ChatGPT apps, only need the address. Add it as a connector, and the app opens a BusinessContacts.io page where you sign in and agree. The page shows which app is asking and what it will be able to do. You can disconnect an app at any time under API in your workspace.

Sign-in follows the MCP authorization standard (OAuth 2.1 with PKCE and automatic client registration). It is new: if an app does not manage to connect this way, use a key as below and tell us which app it was.

2. Use an API key

For apps that take a header instead, create a key under API in your workspace. Give the key a name such as “Cursor” so you can revoke it on its own later.

Header the app must send
Authorization: Bearer YOUR_API_KEY

Claude Code

Run this once in your terminal, then start Claude Code and type /mcp to check the connection.

Terminal
claude mcp add --transport http businesscontacts https://www.businesscontacts.io/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project, then enable the server under Settings → MCP.

mcp.json
{
  "mcpServers": {
    "businesscontacts": {
      "url": "https://www.businesscontacts.io/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json. VS Code asks for the key the first time and keeps it out of the file.

.vscode/mcp.json
{
  "inputs": [
    { "type": "promptString", "id": "bc-key", "description": "BusinessContacts.io API key", "password": true }
  ],
  "servers": {
    "businesscontacts": {
      "type": "http",
      "url": "https://www.businesscontacts.io/api/mcp",
      "headers": { "Authorization": "Bearer ${input:bc-key}" }
    }
  }
}

Claude Desktop

Claude Desktop connects through the small mcp-remote helper (needs Node.js). Open Settings → Developer → Edit Config, add this, and restart the app.

claude_desktop_config.json
{
  "mcpServers": {
    "businesscontacts": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.businesscontacts.io/api/mcp", "--header", "Authorization:${BC_AUTH}"],
      "env": { "BC_AUTH": "Bearer YOUR_API_KEY" }
    }
  }
}

Other assistants

Any MCP client that can sign in with OAuth, or send a custom header to a Streamable HTTP server, will work with the address above.

What it can do

Ask in plain language, for example “find marketing directors at software companies in Germany” or “who do we have at acme.com?”. The assistant picks from these tools.

search_contacts
Free

Search people by keyword, industry, seniority, department, country, company size or company, optionally with the best fit for your ideal customer profile first. Emails and phones come back masked.

search_companies
Free

Search the company directory by name, industry, country or size.

find_company_by_website
Free

The company behind a website address, with how many contacts we hold there.

find_person
Free

One known person, by work email or by name plus company. Details masked.

list_filter_values
Free

The exact values the filters accept.

get_account
Free

Your plan and how many credits you can spend.

list_lists
Free

Your saved lists and how many contacts each holds.

save_to_list
Free

Save contacts from a search to one of your lists, or to a new one. Nothing is revealed.

reveal_contacts
1 credit per new contact

The full email, phone and LinkedIn address for up to 25 contacts. Contacts you or your team already revealed are free.

Credits and safety

  • Only revealing costs credits: one for each contact not revealed before. Everything else is free.
  • The server tells the assistant to say how many contacts it is about to reveal and to get your agreement first. Your assistant app may also ask you to approve each tool call; we recommend keeping that on for reveal_contacts.
  • A reveal is all or nothing. If your credits do not cover it, nothing is revealed and nothing is charged.
  • The same limits as the API apply: 120 requests a minute and 600 searches a day, shared with the workspace.
  • On a team, the assistant uses the team's credits and sees what the team has revealed, within your own limit.
  • To cut an assistant off, revoke its key under API in your workspace. It stops working at once.

Writing your own integration?

The same data is available as a plain REST API.

API documentation