Prospeo MCP server

Prospeo MCP Server

Official Model Context Protocol (MCP) server for Prospeo — giving AI tools native access to B2B lead search and enrichment.

Works with any MCP-compatible client: Claude, Cursor, Windsurf, Claude Code, and more.

Features

• Search Suggestions — Free helper to resolve canonical filter values for locations, job titles, technologies, industries, NAICS, and SIC codes (no credits consumed)
• Enrich Person — Find professional email and mobile phone from a name, LinkedIn URL, or email
• Bulk Enrich People — Enrich up to 25 people in a single call — the canonical follow-up to search_person
• Enrich Company — Get full company profile: headcount, industry, revenue, tech stack, funding, social links
• Bulk Enrich Companies — Enrich up to 25 companies in a single call from a list of names or domains
• Search People — Query Prospeo's professional database with filters (job title, seniority, location, company size, etc.)
• Search Companies — Query Prospeo's company database with filters (industry, headcount, technology, revenue, etc.)
• Account Info — Check credits remaining, plan, and renewal date (free, no credits consumed)

Quick Start

Option 1: Hosted Server (Recommended)

Connect directly to Prospeo's hosted MCP server — no installation needed.

Server URL:

https://mcp.prospeo.io

Authentication is handled via OAuth or by passing your API key in the X-KEY header. Supported by Claude.ai, Claude Desktop, and other remote MCP clients.

Option 2: Local via npx

Run the server locally in stdio mode. Requires Node.js 18+.

Claude Code

claude mcp add prospeo --env PROSPEO_API_KEY=your_api_key -- npx -y @prospeo/prospeo-mcp-server

Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "prospeo": {
      "command": "npx",
      "args": ["-y", "@prospeo/prospeo-mcp-server"],
      "env": {
        "PROSPEO_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings (refer to your client's documentation):

{
  "prospeo": {
    "command": "npx",
    "args": ["-y", "@prospeo/prospeo-mcp-server"],
    "env": {
      "PROSPEO_API_KEY": "your_api_key"
    }
  }
}

Configuration

Environment Variables

Tools

search_suggestions

Resolve canonical filter values before building a search. Free endpoint — does not consume credits. Rate limited to 15 req/sec.

Call this first whenever the user mentions a location, technology, industry, job title, or NAICS / SIC code — guessing strings (e.g. "SF" vs "San Francisco, California, United States") causes empty searches.

Supported types: location, job_title, technology, industry, naics, sic.

enrich_person

Find the professional email address and/or mobile phone number for a person. Use bulkenrichperson instead when you have multiple people to enrich (same per-record cost, one call instead of many).

Required input (at least one):

• linkedin_url — Person's LinkedIn profile URL
• email — Known email address
• personid — From a prior searchperson result
• firstname + lastname + companyname or companywebsite

bulkenrichperson

Enrich up to 25 people in a single call — the canonical follow-up to searchperson. Pass each result's personid as a record; the matched.identifier in the response equals that person_id so you can stitch results back to the original list.

Shortened. The full README is on GitHub.