Surfe MCP Server: Connect Surfe to Your AI Assistant – SURFE

The Surfe MCP Server lets you connect Surfe's people and company data directly to your AI assistant. Search for contacts, enrich leads, and check your credit balance. All without leaving your AI tool.

The Surfe MCP Server is currently in beta. Features and configuration details may change. If you experience any issues, contact our support team.

What is MCP?

MCP stands for Model Context Protocol: A standard that allows AI assistants like Claude to connect directly to external tools and data sources. With the Surfe MCP Server, your AI assistant can access Surfe's data in real time, letting you search and enrich contacts through natural conversation.

Instead of switching between tools, you can simply ask your AI assistant to find contacts, enrich a list of leads, or check your remaining credits and it will do it for you automatically using Surfe's API in the background.

What Can You Do with the Surfe MCP?

The Surfe MCP Server gives your AI assistant access to 7 tools:

Tool	Technical Name	What it does
Search People	`surfe_search_people`	Search for people using filters like job title, seniority, company and location
Start People Enrichment	`surfe_enrich_people`	Start bulk enrichment of people to get emails, phone numbers, and LinkedIn profiles.
Get People Enrichment Status and results	`surfe_get_enrichment_status`	Check the status of a people enrichment and retrieve results when complete
Search Companies	`surfe_search_companies`	Search for companies using filters like industry, size, location and revenue
Start Company Enrichment	`surfe_enrich_companies`	Enrich a list of companies to get detailed firmographic data
Get Company Enrichment Status and results	`surfe_get_company_enrichment_status`	Check the status of a company enrichment and retrieve results when complete
Get Remaining Credits	`surfe_get_credits`	Check your remaining email, mobile and search credits

Supported AI Clients

The Surfe MCP Server works with:

Claude Desktop
Cursor
Windsurf

How to Set It Up

Step 1: Get Your Surfe API Key

Go to Surfe API Settings and generate your API key. You'll need this to authenticate the connection.

→ See: Find your Surfe API Key

Step 2: Add the Surfe MCP Server to Your Client

Choose your AI client below and follow the setup instructions.

Claude Desktop

Step 1: Open Claude and navigate to Customise on the side bar:

Step 2: Go to Connectors and click on the + icon to add Custom Connector:

Step 3: Give it a name and add the MCP server URL: https://mcp.eu.surfe.com/mcp

Step 4: Click on connect and you’ll be prompted to add your API key from Surfe.

Cursor

Add the Surfe MCP server URL to your Cursor settings by adding the following to your .cursor/mcp.json file in your project (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "surfe": {
      "url": "https://mcp.eu.surfe.com/mcp"
    }
  }
}

Windsurf

Add the Surfe MCP server URL to your Windsurf settings by adding the following to your ~/.windsurf/mcp.json file:

{
  "mcpServers": {
    "surfe": {
      "serverUrl": "https://mcp.eu.surfe.com/mcp"
    }
  }
}

Step 3: Start Using Surfe in Your AI Assistant

Once connected, you can ask your AI assistant to use Surfe's data directly in conversation. Here are some examples of what you can ask:

"Search for CEOs at SaaS companies in the UK with 50–200 employees"
"Enrich these contacts and get their email addresses"
"How many email credits do I have left?"
"Find companies in the FinTech industry in France with revenue between 10M and 50M"

Example Workflows

Find and enrich contacts:

Search People → Start People Enrichment → Get People Enrichment Status

Research a company:

Search Companies → Start Company Enrichment → Get Company Enrichment Status

Check remaining credits:

Get Remaining Credits

Things to Know

You'll need a valid Surfe API key to connect
Credits are consumed the same way as the standard Surfe API — email, mobile and search credits apply
The MCP Server uses the same endpoints as the Surfe API so the same quotas and rate limits apply

→ See: API - Credits & Quotas

→ See: API - Rate Limits

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.

Need Help?

If you have any questions or need further assistance setting up the Surfe MCP Server, reach out to our support team.