Skip to Content

Assistant

ToolWhat it does
discover_toolsList the canonical server tools that are implemented and currently available.
thread_searchSearch the caller’s other private assistant chats for past work.

discover_tools

List the canonical server tools that are implemented and currently available.

List and briefly describe the assistant’s own available tools, grouped by category, so the model (or a user asking “what can you do?”) can find the right capability. Free, always available, served from the backend’s own tool registry rather than a data endpoint.

EndpointPOST https://api.prospeo.io/api/v2/tools/discover-tools
MCP tooldiscover_tools on https://mcp.prospeo.io
EffectReads data.
CreditsFree, uses no credits.
PermissionNo role permission beyond API access.
ConfirmationNot needed.
PaginationOffset-based: offset.

Request

Send POST with your API key in the X-KEY header and a JSON body. Unknown fields and query parameters are rejected. The full JSON Schema is served with the tool list.

ParameterTypeRequiredDescription
categorystringNoLength 0 to 80.
offsetintegerNoFrom 0 to 200. Default 0.

Response

{"ok": true, "summary": "...", "payload": {...}} on success. Errors return {"ok": false, "code", "message", "retryable"}; see error codes.

Search the caller’s other private assistant chats for past work.

Search the caller’s other private assistant chats with one free-text query and return matching snippets and thread links.

EndpointPOST https://api.prospeo.io/api/v2/tools/thread-search
MCP toolthread_search on https://mcp.prospeo.io
EffectReads data.
CreditsFree, uses no credits.
PermissionNo role permission beyond API access.
ConfirmationNot needed.
PaginationReturns one page.

Request

Send POST with your API key in the X-KEY header and a JSON body. Unknown fields and query parameters are rejected. The full JSON Schema is served with the tool list.

ParameterTypeRequiredDescription
querystringYesLength 1 to 200.

Response

{"ok": true, "summary": "...", "payload": {...}} on success. Errors return {"ok": false, "code", "message", "retryable"}; see error codes.

Last updated on