Skip to Content
Tools referenceOverview

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 POST with your API key in the X-KEY header and a JSON body. Get an API key .
  • Success returns {"ok": true, "summary": "...", "payload": {...}}. Writes may add changed (the records affected) and charge (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

CategoryTools
Account and billing10
Analytics9
Assistant2
Calls and voicemail6
Contacts and accounts12
CRM integrations19
Deals16
Deliverability5
Email inbox10
Forms6
Imports and exports5
Lists7
Mailboxes11
Meetings9
Notifications3
Prospecting and enrichment2
Recordings7
Saved searches and filters4
Scoring9
Sequence contacts8
Sequences21
Tasks8
Workflows8

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 codecodeDefault messageRetryable
400EXECUTION_FAILEDThe action could not be completed.No
400INTERNAL_ERRORThe operation could not be completed. Please try again.Yes
400INVALID_API_KEYA valid API key is required.No
400INVALID_ARGSThe request arguments are invalid.No
400NOT_RESOLVEDThe action could not be performed as asked.No
400PERMISSION_DENIEDYou don’t have permission to access this resource.No
400PERMISSION_UNVERIFIEDThat action is not available yet.No
429RATE_LIMIT_EXCEEDEDToo many requests. Please try again later.Yes
400TOOL_DISABLEDThis tool is currently unavailable.No
400TOOL_MISSINGThis tool is not available.No

Original endpoints

These endpoints keep their own request and response format.

EndpointMCP tool
POST /account-informationget_account_info
POST /bulk-enrich-companybulk_enrich_company
POST /bulk-enrich-personbulk_enrich_person
POST /enrich-companyenrich_company
POST /enrich-personenrich_person
POST /search-companysearch_company
POST /search-personsearch_person
POST /search-suggestionssearch_suggestions
Last updated on