prospeo-mcp-server — Claude Code MCP server
Hooks your agent up to the Prospeo database: search people and companies, pull work emails and mobile numbers. Handy when you need a contact list without leaving the chat.
claude mcp add --transport http prospeo-mcp-server https://mcp.prospeo.ioWhat prospeo-mcp-server does
The server talks to Prospeo and exposes a set of tools. search_suggestions resolves canonical filter values, search_person and search_company query the database, enrich_person and enrich_company return email, phone and a company profile, while bulk_enrich_person and bulk_enrich_company handle up to 25 records per call. get_account_info reports remaining credits and plan.
Two ways to run it. The hosted option points at https://mcp.prospeo.io, with OAuth or an API key in the X-KEY header. The local one runs through npx and needs Node.js 18+ plus a PROSPEO_API_KEY variable. On startup the server fetches its tool table from the backend; if that fetch fails, eight compatibility tools load instead, and a restart of the MCP process is needed once a new catalog ships.
Credits apply to enrichment: one per matched email, ten for email plus mobile. search_suggestions and get_account_info cost nothing. Call search_suggestions before filtering by location or job title — a guessed string like “SF” instead of “San Francisco, California, United States” returns an empty search.
What it helps with
- find a work email from a LinkedIn profile URL
- build a company list by industry and headcount
- enrich 25 contacts in one call
- pull a company profile with revenue, tech stack and funding
- check remaining credits before running enrichment
Example prompts for the agent
- Search Prospeo for Head of Sales people in Berlin and show their emails
- Enrich these 20 contacts: get work email and mobile number
- Build a company profile for example.com: headcount, industry, tech stack
How to install prospeo-mcp-server
1Platform CLI: remote server
claude mcp add --transport http prospeo-mcp-server https://mcp.prospeo.io2Platform CLI
claude mcp add --env PROSPEO_API_KEY=<PROSPEO_API_KEY> --transport stdio prospeo-mcp-server -- npx -y @prospeo/prospeo-mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add prospeo-mcp-server --url https://mcp.prospeo.io2Platform CLI
codex mcp add prospeo-mcp-server --env PROSPEO_API_KEY=<PROSPEO_API_KEY> -- npx -y @prospeo/prospeo-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"prospeo-mcp-server": {
"url": "https://mcp.prospeo.io"
}
}
}{
"mcpServers": {
"prospeo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@prospeo/prospeo-mcp-server"
],
"env": {
"PROSPEO_API_KEY": "<PROSPEO_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"prospeo-mcp-server": {
"type": "http",
"url": "https://mcp.prospeo.io"
}
}
}{
"servers": {
"prospeo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@prospeo/prospeo-mcp-server"
],
"env": {
"PROSPEO_API_KEY": "<PROSPEO_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http prospeo-mcp-server https://mcp.prospeo.io2Platform CLI
gemini mcp add -e PROSPEO_API_KEY=<PROSPEO_API_KEY> prospeo-mcp-server npx -y @prospeo/prospeo-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about prospeo-mcp-server
How do I install prospeo-mcp-server in Claude Code?
Hosted: claude mcp add --transport http prospeo-mcp-server https://mcp.prospeo.io. Local: claude mcp add --env PROSPEO_API_KEY=<PROSPEO_API_KEY> --transport stdio prospeo-mcp-server -- npx -y @prospeo/prospeo-mcp-server.
What does prospeo-mcp-server do?
It connects your agent to the Prospeo database: people and company search with filters, enrichment with emails and mobile numbers, bulk calls of up to 25 records. It also reports remaining credits.
Do I need a Prospeo API key?
For the local npx setup, yes — the PROSPEO_API_KEY variable. The hosted server authenticates via OAuth or a key in the X-KEY header.
