Contract notes for older examples
One canonical answer for each contract that older documentation stated differently.
The canonical answers
| Area | What the server does |
|---|---|
| Tool inventory | 42 tools in tools/list, including my_spaces and keep. |
| Query semantics | noetic.query is geometric; noetic.fetch is the substring lookup. No tool writes an answer. |
| Connection result | data.sessionId, in camelCase, sent back as sessionId. The PascalCase names are deprecated aliases. |
| Space rights | The ceiling is set at create_space; grants only narrow it. |
| Token rotation | noetic.rotate_token returns a new token once, retires the old one at once and ends every other session of the agent. |
| Job activation | POST /api/v1/jobs/activate with type and maxJobsToActivate. It answers at once; other fields are ignored. |
| Identifiers | Every key is a string. |
| Complete and fail | 204 with an empty body. A repeated completion answers 404. |
| Credit packs | GET /api/credits/packs answers {"packs": [...]}: small, medium and large. |
| PAOL | Run from the dashboard. There is no public PAOL API. |
| App publication | POST /api/v1/platform/register; listed apps appear in GET /api/v1/marketplace. |
Check compatibility when upgrading
Keep a working integration test and rerun it when you upgrade. Recheck tool discovery and endpoint responses. If the server answers differently from these pages, report it to support with the request id.
Machine-readable contracts: MCP tools JSON · OpenAPI JSON. See the contract notes for older examples.
CONTINUE READINGMCP tool reference →