Copy page

Documentation

MCP Server

Connect Evaboot to Claude, ChatGPT, Cursor, or any MCP-compatible client. Your assistant can then build Sales Navigator searches, launch exports, and find or validate emails on your behalf.

Nothing to install — the server is hosted.

Server URL: https://mcp.evaboot.com/mcp

Which connection method do I use?

Method	Use it for	How you sign in
Browser sign-in (OAuth)	claude.ai, Claude Desktop, ChatGPT	Click through an Evaboot login + consent screen. No API key needed.
API key	Claude Code, Cursor, VS Code, scripts	Paste your Evaboot API key into a config file.

Web chat UIs (claude.ai, ChatGPT) can't send custom headers, so they use OAuth. Config-file clients can use either, but the API key is simpler.

Both methods give access to the same tools and draw on the same credit balance.

Connect with browser sign-in (OAuth)

claude.ai and Claude Desktop

Remote connectors are attached to your Claude account, so adding it once covers web and desktop.

1. In Claude, go to Customize → Connectors.
2. Click +, then Add custom connector.
3. Enter the URL https://mcp.evaboot.com/mcp and click Add.
4. Click Connect. A browser window opens on Evaboot.
5. Sign in to your Evaboot account if you aren't already.
6. On the Authorize screen, confirm access and click Authorize.

Claude returns to the connector list showing Evaboot as connected. Leave the Advanced/OAuth credential fields empty — the server registers Claude automatically.

Free Claude plans allow one custom connector; paid plans allow several. On Team/Enterprise an owner adds the connector in Organization settings → Connectors and members then click Connect.

ChatGPT

Custom connectors require developer mode, available on Pro, Plus, Business, Enterprise and Education plans, on the web.

1. Go to Settings → Apps → Advanced settings and turn on Developer mode.
2. In the Connectors panel, click Add custom connector.
3. Enter https://mcp.evaboot.com/mcp. Leave authentication as OAuth.
4. Complete the Evaboot sign-in and consent screen.
5. The connector appears under Drafts, then in the composer's Developer Mode tool picker — enable Evaboot for the conversation you want to use it in.

On Business/Enterprise workspaces an admin may first need to allow developer mode under Workspace Settings → Permissions & Roles → Connected Data.

If the server's tools change later, hit Refresh on the connector's settings page.

Connect with an API key

Find your key in the Evaboot dashboard under Integrations → API. If you don't have one yet, click Refresh to generate it. The same panel lets you rotate or delete a key — both immediately break any integration still using the old value.

Your API key is a long-lived secret with full access to your Evaboot account. Treat it like a password and never commit it to a repository.

Claude Code

Code
claude mcp add --transport http evaboot https://mcp.evaboot.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Then run /mcp inside Claude Code to confirm Evaboot is connected.

You can also omit --header and let Claude Code run the OAuth flow instead:

Code
claude mcp add --transport http evaboot https://mcp.evaboot.com/mcp

Cursor

Create .cursor/mcp.json in your project:

Code
{
  "mcpServers": {
    "evaboot": {
      "url": "https://mcp.evaboot.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (Copilot)

Create .vscode/mcp.json:

Code
{
  "servers": {
    "evaboot": {
      "type": "http",
      "url": "https://mcp.evaboot.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Restart the client after editing any config file.

Available tools

17 tools, mirroring the Evaboot public API.

Search building

Tool	What it does	Credits
build_search	Turns a natural-language audience into a validated Sales Navigator URL using Evaboot's search agent. Resolves industries, titles and company names against LinkedIn's real filter catalog. Preferred.	Free
get_search_result	Polls a company-first search started by build_search.	Free
build_search_url	Simpler, single-shot URL builder. Capped at 100 calls/day.	Free

build_search may run a company-first search, which takes several minutes and creates account lists in your own LinkedIn account. Poll get_search_result for progress.

Extracting leads

Tool	What it does	Credits
launch_export_from_url	Starts an export from a Sales Navigator search or list URL. Asynchronous — returns an extraction_id.	1 per lead
extract_profiles	Bulk export from a list of profile URLs or ids (1–2500). Asynchronous.	1 per lead
extract_single_profile	Extracts one profile and returns it immediately.	1
get_extraction	Fetches an export's status, progress, and results.	Free
list_extractions	Lists your exports, newest first.	Free

Set enrich_email to matching (same-domain emails only) or all to find emails during the export.

Finding emails

Tool	What it does	Credits
find_email_single	Finds one email from a name + company. Immediate.	1
find_emails	Bulk email-finder job. Asynchronous.	1 per prospect
get_email_finder_job	Fetches a job's status and results.	Free
list_email_finder_jobs	Lists your email-finder jobs.	Free

Validating emails

Tool	What it does	Credits
validate_email_single	Validates one address. Immediate.	0.5
validate_emails	Bulk validation job. Asynchronous.	0.5 per email, rounded up
get_email_validation_job	Fetches a job's status and results.	Free
list_email_validation_jobs	Lists your validation jobs.	Free

Account

Tool	What it does	Credits
get_quota	Your remaining daily export quota and credit balance.	Free

Costs and limits

• Exports and email lookups consume credits from your Evaboot balance. For exports the credits are checked when you launch and charged when the export completes, based on the number of leads actually found.
• Exports also consume daily quota, tied to your connected Sales Navigator seat. Call get_quota before a large run.
• build_search_url is capped at 100 calls/day.
• If you have no connected Sales Navigator account your quota is 0 — connect one by running any extraction from the Evaboot browser extension first.

Example

"Find marketing directors at French SaaS companies with 50–200 employees, then export the first 50 with emails."

The assistant calls build_search to produce the search URL, then launch_export_from_url with enrich_email, then polls get_extraction until results are ready.

Troubleshooting

Connection fails, or the client reports 401. On the API-key path, check the header is exactly Authorization: Bearer <key> and the key is current. On the OAuth path, disconnect and reconnect to redo the consent flow.

Tools return "insufficient credits" (402). Check your balance with get_quota or in the Evaboot dashboard.

Tools return a quota error (429). You've hit your daily export limit for the Sales Navigator seat, or the search-builder's 100/day cap. Wait for the daily reset.

Quota shows 0. Your Evaboot account has no connected Sales Navigator account. Run one small extraction from the browser extension to link it.

The client shows no tools after connecting. Refresh the connector's tool list (ChatGPT has an explicit Refresh button), or remove and re-add the server.