{
  "markdown": "# Prospeo MCP Server\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Prospeo](https://prospeo.io) — giving AI tools native access to B2B lead search and enrichment.\n\nWorks with any MCP-compatible client: **Claude**, **Cursor**, **Windsurf**, **Claude Code**, and more.\n\n## Features\n\n- **Search Suggestions** — Free helper to resolve canonical filter values for locations, job titles, technologies, industries, NAICS, and SIC codes (no credits consumed)\n- **Enrich Person** — Find professional email and mobile phone from a name, LinkedIn URL, or email\n- **Bulk Enrich People** — Enrich up to 25 people in a single call — the canonical follow-up to `search_person`\n- **Enrich Company** — Get full company profile: headcount, industry, revenue, tech stack, funding, social links\n- **Bulk Enrich Companies** — Enrich up to 25 companies in a single call from a list of names or domains\n- **Search People** — Query Prospeo's professional database with filters (job title, seniority, location, company size, etc.)\n- **Search Companies** — Query Prospeo's company database with filters (industry, headcount, technology, revenue, etc.)\n- **Account Info** — Check credits remaining, plan, and renewal date (free, no credits consumed)\n\n## Quick Start\n\n### Option 1: Hosted Server (Recommended)\n\nConnect directly to Prospeo's hosted MCP server — no installation needed.\n\n**Server URL:**\n```\nhttps://mcp.prospeo.io\n```\n\nAuthentication 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.\n\n### Option 2: Local via npx\n\nRun the server locally in stdio mode. Requires [Node.js](https://nodejs.org) 18+.\n\n#### Claude Code\n\n```bash\nclaude mcp add prospeo --env PROSPEO_API_KEY=your_api_key -- npx -y @prospeo/prospeo-mcp-server\n```\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"prospeo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@prospeo/prospeo-mcp-server\"],\n      \"env\": {\n        \"PROSPEO_API_KEY\": \"your_api_key\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor / Windsurf\n\nAdd to your MCP settings (refer to your client's documentation):\n\n```json\n{\n  \"prospeo\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@prospeo/prospeo-mcp-server\"],\n    \"env\": {\n      \"PROSPEO_API_KEY\": \"your_api_key\"\n    }\n  }\n}\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `PROSPEO_API_KEY` | Yes (stdio mode) | — | Your Prospeo API key. Get one at [app.prospeo.io/api](https://app.prospeo.io/api) |\n| `LOG_LEVEL` | No | `INFO` | Logging level: `DEBUG`, `INFO`, `WARN`, `ERROR` |\n\n## Tools\n\n### search_suggestions\n\nResolve canonical filter values before building a search. Free endpoint — does not consume credits. Rate limited to 15 req/sec.\n\nCall 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.\n\n**Supported types:** `location`, `job_title`, `technology`, `industry`, `naics`, `sic`.\n\n### enrich_person\n\nFind 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).\n\n**Required input** (at least one):\n- `linkedin_url` — Person's LinkedIn profile URL\n- `email` — Known email address\n- `person_id` — From a prior `search_person` result\n- `first_name` + `last_name` + `company_name` or `company_website`\n\n### bulk_enrich_person\n\nEnrich 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.\n\nPer-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.\n\n### enrich_company\n\nGet a full company profile including headcount, industry, revenue, tech stack, funding, social links, attributes, and job postings.\n\n**Required input** (at least one):\n- `company_website` (recommended, most accurate)\n- `company_name`\n- `company_linkedin_url`\n- `company_id` — From a prior search or enrich result\n\n### bulk_enrich_company\n\nEnrich 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.\n\n### search_person\n\nSearch Prospeo's professional database using typed filters. Returns up to 25 results per page. Costs 1 credit per page of results.\n\n**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.\n\n### search_company\n\nSearch Prospeo's company database using typed filters. Returns up to 25 results per page. Costs 1 credit per page of results.\n\n**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.\n\n### get_account_info\n\nCheck your Prospeo account status — credits remaining, plan name, renewal date, and team size. Free endpoint, no credits consumed.\n\n## Examples\n\n### Example 1: Find someone's email from LinkedIn\n\n**Prompt:**\n> Find the professional email for the person at linkedin.com/in/johndoe\n\n**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.\n\n### Example 2: Research a company before outreach\n\n**Prompt:**\n> Give me a full profile of stripe.com — headcount, funding, tech stack, everything\n\n**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.\n\n### Example 3: Build a lead list with filters\n\n**Prompt:**\n> Find VP-level people in SaaS companies with 50-200 employees in the US\n\n**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.\n\n### Example 4: Find companies using a specific technology\n\n**Prompt:**\n> Search for companies that use Salesforce and have more than 500 employees\n\n**What happens:** The server calls `search_company` with technology and headcount filters. Returns matching companies with domain, industry, size, location, and tech stack details.\n\n### Example 5: Check remaining credits\n\n**Prompt:**\n> How many Prospeo credits do I have left?\n\n**What happens:** The server calls `get_account_info` and returns your current plan, credits remaining, renewal date, and team size — without consuming any credits.\n\n## Authentication\n\n### Hosted server (mcp.prospeo.io)\n\nThe hosted server supports two authentication methods:\n\n1. **OAuth 2.0** — Used by Claude.ai and Claude Desktop. The OAuth consent flow is handled automatically when connecting through the MCP directory.\n2. **API Key header** — Pass your API key in the `X-KEY` header for direct programmatic access.\n\n### Local server (stdio mode)\n\nPass 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.\n\n## Privacy Policy\n\nSee our privacy policy: [https://prospeo.io/privacy-policy](https://prospeo.io/privacy-policy)\n\n## Support\n\n- Email: [support@prospeo.io](mailto:support@prospeo.io)\n- Helpdesk: [https://help.prospeo.io](https://help.prospeo.io)\n- MCP Documentation: [https://prospeo.io/mcp-docs](https://prospeo.io/mcp-docs)\n- REST API Documentation: [https://prospeo.io/api-docs](https://prospeo.io/api-docs)\n- Issues: [https://github.com/prospeo-v2/prospeo-mcp-server/issues](https://github.com/prospeo-v2/prospeo-mcp-server/issues)\n\n## License\n\nMIT\n",
  "bytes": 8601,
  "sha": "1175e7e09af9ac5ee825650957b4c8c1ecbd9d059573649896f7961488b0fb30",
  "repo_slug": "prospeo-v2/prospeo-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_prospeo_prospeo_mcp_server_f70d50d5/readme"
}