MCP Server

Connect AI assistants like Claude to Surfe's people and company data via the Model Context Protocol.

Beta

The Surfe MCP Server lets AI assistants like Claude Desktop, Cursor, Windsurf, and any other MCP-compatible client search, enrich, and look up Surfe data directly, without writing any code against the REST API.

To connect, add the server URL to your client and sign in with your Surfe API key. Your client exchanges the key for a managed token, so you enter it just once.

https://mcp.eu.surfe.com/mcp

Quick start

Get your Surfe API key

Generate or copy a key in API Settings — the MCP server uses the same key as the REST API. You'll paste it once when you sign in.

Add Surfe to your AI client

Open Settings → Connectors (in current builds this opens the Customize window), then click + → Add custom connector and enter:

Name: Surfe
URL: https://mcp.eu.surfe.com/mcp

Click Add. Surfe now appears under your connectors — click Connect to start sign-in.

Connecting opens Surfe's sign-in page in your browser. Paste your Surfe API key and click Connect. Your client confirms the connection and the Surfe tools appear in its tools menu.

Test it

Ask your assistant:

Check my credits

You should see your remaining Surfe email and mobile credits — confirming the connection works.

Authentication

Surfe MCP authenticates with your Surfe API key — the same key as the REST API, available in API Settings. There are two ways to provide it:

Browser sign-in (recommended). When you connect, Surfe's sign-in page opens in your browser. You paste your API key once; your client then holds a managed token and never stores the raw key. Revoke access anytime from Surfe.
Per-call key. If your client can't open the browser flow, give your assistant the key directly and it passes it on every Surfe call:

My Surfe API key is your_api_key. Use it for all Surfe requests.

Add that same line to your client's custom instructions or project rules so you don't have to repeat it.

See it in action in Claude Code

What's available today

The server exposes 8 tools covering the same surface as the Surfe REST API.

People

Search, start enrichment, fetch enrichment results.

Companies

Search, start enrichment, fetch enrichment results.

Account

Check remaining email and mobile credits.

Each tool's permission is set in your client, so you stay in control of when Surfe can read data or spend credits.

Example flows

Once Surfe is connected, you can ask your AI assistant things like:

Find and enrich contacts

"Find VPs of Engineering at fintech companies in Germany and enrich the top 5 with email addresses."

Research a company

"Pull firmographic data on notion.so: employee count, industry, revenue."

Check remaining credits

"How many Surfe email and mobile credits do I have left this month?"