# prospeo-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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: prospeo-v2
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/prospeo-v2/prospeo-mcp-server
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/prospeo-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.prospeo.io`
- Environment variables: `PROSPEO_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http prospeo-mcp-server https://mcp.prospeo.io
```

2. **Platform CLI**
```bash
claude mcp add --env PROSPEO_API_KEY=<PROSPEO_API_KEY> --transport stdio prospeo-mcp-server -- npx -y @prospeo/prospeo-mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add prospeo-mcp-server --url https://mcp.prospeo.io
```

2. **Platform CLI**
```bash
codex mcp add prospeo-mcp-server --env PROSPEO_API_KEY=<PROSPEO_API_KEY> -- npx -y @prospeo/prospeo-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prospeo-mcp-server": {
            "url": "https://mcp.prospeo.io"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prospeo-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@prospeo/prospeo-mcp-server"
            ],
            "env": {
                "PROSPEO_API_KEY": "<PROSPEO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "prospeo-mcp-server": {
            "type": "http",
            "url": "https://mcp.prospeo.io"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http prospeo-mcp-server https://mcp.prospeo.io
```

2. **Platform CLI**
```bash
gemini mcp add -e PROSPEO_API_KEY=<PROSPEO_API_KEY> prospeo-mcp-server npx -y @prospeo/prospeo-mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [cargo-gtm](https://affpapa.org/en/nevibecode/skills/cargo-gtm.md) — skill · 10000 installs
- [FullEnrich](https://affpapa.org/en/nevibecode/mcp/fullenrich.md) — MCP server · ★ 10
- [contact-research](https://affpapa.org/en/nevibecode/skills/contact-research.md) — skill · 2900 installs
- [prospect](https://affpapa.org/en/nevibecode/skills/prospect.md) — skill · 2900 installs
- [mcp](https://affpapa.org/en/nevibecode/mcp/apolloio-mcp.md) — MCP server · ★ 33
- [Tomba MCP Server](https://affpapa.org/en/nevibecode/mcp/tomba-mcp-server.md) — MCP server · ★ 8

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md