io.prospeo/prospeo-mcp-server
Prospeo: Find, search, and enrich people and companies with verified emails and mobile numbers.
Open source Repository Open in the app JSON README (API)
About
Prospeo: Find, search, and enrich people and companies with verified emails and mobile numbers.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- io.prospeo
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.0
- Last push
- 2026-07-03T00:24:34Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:45
- Updated
- 2026-08-29 04:01:45
- Origin id
io.prospeo/prospeo-mcp-server
README
# Prospeo MCP Server
Official [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Prospeo](https://prospeo.io) — 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](https://nodejs.org) 18+.
#### Claude Code
```bash
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`:
```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):
```json
{
"prospeo": {
"command": "npx",
"args": ["-y", "@prospeo/prospeo-mcp-server"],
"env": {
"PROSPEO_API_KEY": "your_api_key"
}
}
}
```
## Configuration
### Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
| `PROSPEO_API_KEY` | Yes (stdio mode) | — | Your Prospeo API key. Get one at [app.prospeo.io/api](https://app.prospeo.io/api) |
| `LOG_LEVEL` | No | `INFO` | Logging level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
## 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 `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 URL
- `email` — Known email address
- `person_id` — From a prior `search_person` result
- `first_name` + `last_name` + `company_name` or `company_website`
### bulk_enrich_person
Enrich 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.
### enrich_company
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_name`
- `company_linkedin_url`
- `company_id` — From a prior search or enrich result
### bulk_enrich_company
Enrich 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_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`, `person_search`, `person_name`, `person_job_change`, `person_contact_details`, 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`, `company_intent`, `company_icp`, `company_lookalike`, `company_key_execs`, `company_website_traffic`, `company_integrations`, 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 company before outreach
**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.
### Example 3: Build a lead list with filters
**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.
### Example 4: Find companies using a specific technology
**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.
### Example 5: Check remaining credits
**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.
## Authentication
### Hosted server (mcp.prospeo.io)
The hosted server supports two authentication methods:
1. **OAuth 2.0** — Used by Claude.ai and Claude Desktop. The OAuth consent flow is handled automatically when connecting through the MCP directory.
2. **API Key header** — Pass your API key in the `X-KEY` header for direct programmatic access.
### Local server (stdio mode)
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.
## Privacy Policy
See our privacy policy: [https://prospeo.io/privacy-policy](https://prospeo.io/privacy-policy)
## Support
- Email: [support@prospeo.io](mailto:support@prospeo.io)
- Helpdesk: [https://help.prospeo.io](https://help.prospeo.io)
- MCP Documentation: [https://prospeo.io/mcp-docs](https://prospeo.io/mcp-docs)
- REST API Documentation: [https://prospeo.io/api-docs](https://prospeo.io/api-docs)
- Issues: [https://github.com/prospeo-v2/prospeo-mcp-server/issues](https://github.com/prospeo-v2/prospeo-mcp-server/issues)
## License
MIT