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.

HTTP status: 400

​
Error message

duplicate tool aliases (must be unique across mcp_servers + client_tools): {dupes}

​
When this error occurs

Aliases are the namespace the workflow uses to route each {alias}-{tool_name} call to the right MCP server (server-resolved) or terminate the run with requires_action (client-resolved). Two entries with the same alias would make routing ambiguous, so the API rejects them up front. Uniqueness is enforced across the union of mcp_servers and client_tools, not just within each list — you can’t have an MCP server aliased docs and a client tool also aliased docs.

​
How to fix

Pick distinct aliases: 
{
  "mcp_servers": [{ "alias": "docs", ... }],
  "client_tools": [{ "alias": "user", ... }]
}
If you genuinely need two different MCP servers for related capabilities, distinguish them semantically (docsv1, docsv2) rather than reusing one alias.