agent.version

Live

Return the active (mcp_tool_surface_version, world_version, schema_version) tuple.

CategoryAgent
JSON-RPCtools/call
EndpointPOST /mcp
Sourcepackages/mcp-tools/src/tools/agent-version.ts

Description

The canonical runtime version snapshot. Per ADR-0021 §capabilities.

Input schema

This tool takes no arguments.

Output shape

typescript
{ mcp_tool_surface_version: string; world_version: string; schema_version: string }

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

jsontools/call params
{ "name": "agent.version", "arguments": {} }

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

jsonparsed result body
{ "mcp_tool_surface_version": "v1.0.0", "world_version": "wv_01HXR4WORLD", "schema_version": "1.0" }

Errors this tool can return

CodeMeaning
unauthorizedMissing or invalid bearer token.

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).