The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Prospeo MCP Server listing page.
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.
search_personConnect directly to Prospeo's hosted MCP server — no installation needed.
Server URL:
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.
Run the server locally in stdio mode. Requires Node.js 18+.
Add to your claude_desktop_config.json:
Add to your MCP settings (refer to your client's documentation):
| Variable | Required | Default | Description |
|---|---|---|---|
PROSPEO_API_KEY | Yes (stdio mode) | — | Your Prospeo API key. Get one at app.prospeo.io/api |
LOG_LEVEL | No | INFO | Logging level: DEBUG, INFO, WARN, ERROR |
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.
Find the professional email address and/or mobile phone number for a person. Use bulk_enrich_person 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 URLemail — Known email addressperson_id — From a prior search_person resultfirst_name + last_name + company_name or company_websiteEnrich up to 25 people in a single call — the canonical follow-up to search_person. Pass each result's person_id as a record; the matched.identifier in the response equals that person_id so you can stitch results back to the original list.
Per-record credit cost is identical to enrich_person (1 credit per matched email, 10 per matched email + mobile). Returns a compact response per record (no job_history, no skills, abbreviated company summary) — use enrich_person if you need the full profile for a specific person.
Get a full company profile including headcount, industry, revenue, tech stack, funding, social links, attributes, and job postings.
Required input (at least one):
company_website (recommended, most accurate)company_namecompany_linkedin_urlcompany_id — From a prior search or enrich resultEnrich up to 25 companies in a single call — the canonical lookup tool when you already have a list of company names or domains (CRM exports, account lists, competitor maps). Returns the full company profile per match. 1 credit per matched company. identifier defaults to company_id when provided so chaining from search_company results is trivial.
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, person_search, person_name, person_job_change, person_contact_details, and more.
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, company_intent, company_icp, company_lookalike, company_key_execs, company_website_traffic, company_integrations, and more.
Check your Prospeo account status — credits remaining, plan name, renewal date, and team size. Free endpoint, no credits consumed.
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.
Prompt:
Give me a full profile of stripe.com — headcount, funding, tech stack, everything
What happens: The server calls enrich_company with the domain and returns the company's industry, employee count, revenue range, technologies used, funding rounds, social links, and headquarters location.
Prompt:
Find VP-level people in SaaS companies with 50-200 employees in the US
What happens: The server calls search_person with seniority, industry, headcount, and location filters. Returns up to 25 matching professionals per page with name, title, company, email, and LinkedIn URL.
Prompt:
Search for companies that use Salesforce and have more than 500 employees
What happens: The server calls search_company with technology and headcount filters. Returns matching companies with domain, industry, size, location, and tech stack details.
Prompt:
How many Prospeo credits do I have left?
What happens: The server calls get_account_info and returns your current plan, credits remaining, renewal date, and team size — without consuming any credits.
The hosted server supports two authentication methods:
X-KEY header for direct programmatic access.Pass your API key via the PROSPEO_API_KEY environment variable. The server validates the key on startup and exits with a clear error if it's missing.
See our privacy policy: https://prospeo.io/privacy-policy
MIT