# Prospeo — how to use (mcp.ai)

Connect your Prospeo account and use 8 tools for AI sales tools straight from your AI agent. Connect with your own API key. Prospeo provides B2B person and company search, enrichment, and verified contact data through its REST API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_prospeo?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `prospeo_bulk_enrich_companies`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/prospeo`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/prospeo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/prospeo/bulk/enrich/companies` — Match 1-50 companies and correlate outcomes by caller-generated identifier. Costs 1 credit per match; no match and repeats within 90 days are free. The REST maximum is 50. FREE probing only accepted o
  - body: { companies: object[] }
- `POST https://api.mcp.ai/api/prospeo/bulk/enrich/people` — Match 1-50 people and correlate every outcome by a caller-generated identifier. A found email/person costs 1 credit; each requested and found mobile costs 10 credits and includes email enrichment. No 
  - body: { people: object[], enrich_mobile?: boolean, only_verified_email?: boolean, only_verified_mobile?: boolean }
- `POST https://api.mcp.ai/api/prospeo/enrich/company` — Match one company and return its full profile. Costs 1 credit when matched; no match and repeat enrichment within 90 days are free. FREE rate limit: 1/second, 20/minute, 50/day.
  - body: { company: object }
- `POST https://api.mcp.ai/api/prospeo/enrich/person` — Match one person and return profile, company, and verified contact data. A found email/person costs 1 credit. Requesting and finding mobile costs 10 credits and also includes email enrichment. No matc
  - body: { person: object, enrich_mobile?: boolean, only_verified_email?: boolean, only_verified_mobile?: boolean }
- `POST https://api.mcp.ai/api/prospeo/get/account/information` — Return the connected Prospeo team's plan, remaining and used credits, team size, and quota-renewal date. This free endpoint is the recommended preflight before credit-consuming search or enrichment.
- `POST https://api.mcp.ai/api/prospeo/search/companies` — Search Prospeo's company database with typed practical and advanced filters. Returns one page of at most 25 companies. Each non-empty page costs 1 credit unless the team paid for the identical page wi
  - body: { filters?: object, next_cursor?: string }
- `POST https://api.mcp.ai/api/prospeo/search/people` — Search Prospeo's person database with typed person and company filters. Returns profiles and contact availability but never reveals email or mobile values. Each non-empty page costs 1 credit unless th
  - body: { filters?: object, next_cursor?: string }
- `POST https://api.mcp.ai/api/prospeo/search/suggestions` — Resolve canonical Prospeo filter values for locations, titles, technologies, industries, codes, and advanced company fields. Free and consumes no credits. Send exactly one suggestion type. Rate limit:
  - body: { query: string, suggestion_type: string }

## Example prompts
- "What can I do in Prospeo?"
- "Show me a summary of my Prospeo account"

## More
- Page: https://mcp.ai/prospeo
- Agent spec (llms.txt): https://mcp.ai/prospeo/llms.txt
- Postman collection: https://mcp.ai/prospeo/postman.json