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.
https://www.businesscontacts.io/api/mcp1. 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.
Authorization: Bearer YOUR_API_KEYClaude Code
Run this once in your terminal, then start Claude Code and type /mcp to check the connection.
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.
{
"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.
{
"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.
{
"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.