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

• Enrich Person — Find professional email and mobile phone from a name, LinkedIn URL, or email
• Enrich Company — Get full company profile: headcount, industry, revenue, tech stack, funding, social links
• 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 claude_desktop_config.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

enrich_person

Find the professional email address and/or mobile phone number for a person.

Required input (at least one):

• linkedin_url — Person's LinkedIn profile URL
• email — Known email address
• first_name + last_name + company_name or company_website

enrich_company

Get a full company profile including headcount, industry, revenue, tech stack, funding, and social links.

Required input (at least one):

• company_website (recommended, most accurate)
• company_name
• company_linkedin_url

search_person

Search Prospeo's professional database using typed filters. Returns up to 25 results per page. Costs 1 credit per page of results.

Filters include: person_job_title, person_seniority, person_location_search, company_industry, company_headcount_range, company_technology, and more.

search_company

Search Prospeo's company database using typed filters. Returns up to 25 results per page. Costs 1 credit per page of results.

Filters include: company_industry, company_headcount_range, company_location_search, company_technology, company_revenue, company_funding, and more.

get_account_info

Check your Prospeo account status — credits remaining, plan name, renewal date, and team size. Free endpoint, no credits consumed.

Examples

Example 1: Find someone's email from LinkedIn

Prompt:

Find the professional email for the person at linkedin.com/in/johndoe

What happens: The server calls enrich_person with the LinkedIn URL and returns the person's verified professional email, current job title, company, and phone number if available.

Example 2: Research a compan

... View full README on GitHub