Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

Surface: GET /agents/runs/{id}, error.type = "UnknownTool"

​
When this error occurs

The workflow called an MCP server’s tools/call for a tool name that the server doesn’t recognise. JSON-RPC reports this as -32601 method not found. Causes:
  • The MCP server’s tool catalog has changed since the conversation was created (server-side refactor).
  • The configured mcp_servers[].tools[].name doesn’t actually exist on the server (typo, stale config).
  • The server is behind a load balancer where some instances have the tool and some don’t (server-side deploy issue).

​
How to fix

  1. Verify the tool name against the MCP server’s tools/list response (curl it directly with a JSON-RPC client).
  2. Update defaults.mcp_servers[].tools[] to match the server’s current catalog.
  3. If the discrepancy is intermittent, fix the server-side deploy first.