Assistant
| Tool | What it does |
|---|---|
discover_tools | List the canonical server tools that are implemented and currently available. |
thread_search | Search 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.
| Endpoint | POST https://api.prospeo.io/api/v2/tools/discover-tools |
| MCP tool | discover_tools on https://mcp.prospeo.io |
| Effect | Reads data. |
| Credits | Free, uses no credits. |
| Permission | No role permission beyond API access. |
| Confirmation | Not needed. |
| Pagination | Offset-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | No | Length 0 to 80. |
offset | integer | No | From 0 to 200. Default 0. |
Response
{"ok": true, "summary": "...", "payload": {...}} on success. Errors return {"ok": false, "code", "message", "retryable"}; see error codes.
thread_search
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.
| Endpoint | POST https://api.prospeo.io/api/v2/tools/thread-search |
| MCP tool | thread_search on https://mcp.prospeo.io |
| Effect | Reads data. |
| Credits | Free, uses no credits. |
| Permission | No role permission beyond API access. |
| Confirmation | Not needed. |
| Pagination | Returns 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Length 1 to 200. |
Response
{"ok": true, "summary": "...", "payload": {...}} on success. Errors return {"ok": false, "code", "message", "retryable"}; see error codes.