Tools reference
197 tools, each available as a REST endpoint at https://api.prospeo.io/api/v2/tools/<tool-name> and as an MCP tool of the same name on the Prospeo MCP server (https://mcp.prospeo.io).
- Send
POSTwith your API key in theX-KEYheader and a JSON body. Get an API key . - Success returns
{"ok": true, "summary": "...", "payload": {...}}. Writes may addchanged(the records affected) andcharge(credits used). - The tool list with its JSON Schemas is also served as data at
https://api.prospeo.io/api/v2/mcp/tools(POST, no key needed).
Categories
Error codes
Errors return HTTP 400 (or 429 when rate limited) with {"ok": false, "code": "...", "message": "...", "retryable": false}. When a request can’t be done as asked, NOT_RESOLVED explains why in message.
| HTTP code | code | Default message | Retryable |
|---|---|---|---|
400 | EXECUTION_FAILED | The action could not be completed. | No |
400 | INTERNAL_ERROR | The operation could not be completed. Please try again. | Yes |
400 | INVALID_API_KEY | A valid API key is required. | No |
400 | INVALID_ARGS | The request arguments are invalid. | No |
400 | NOT_RESOLVED | The action could not be performed as asked. | No |
400 | PERMISSION_DENIED | You don’t have permission to access this resource. | No |
400 | PERMISSION_UNVERIFIED | That action is not available yet. | No |
429 | RATE_LIMIT_EXCEEDED | Too many requests. Please try again later. | Yes |
400 | TOOL_DISABLED | This tool is currently unavailable. | No |
400 | TOOL_MISSING | This tool is not available. | No |
Original endpoints
These endpoints keep their own request and response format.
| Endpoint | MCP tool |
|---|---|
POST /account-information | get_account_info |
POST /bulk-enrich-company | bulk_enrich_company |
POST /bulk-enrich-person | bulk_enrich_person |
POST /enrich-company | enrich_company |
POST /enrich-person | enrich_person |
POST /search-company | search_company |
POST /search-person | search_person |
POST /search-suggestions | search_suggestions |
Last updated on