{"protocolVersion":"0.3.0","name":"Retrace","description":"Execution replay engine for AI agents. Records every model call, tool invocation, retrieval, and error as a trace; replays it step by step; forks from any span with a modified input and cascade-replays the downstream execution; and proves whether a change improved, regressed, or did nothing.","url":"https://api.retraceai.tech/mcp","preferredTransport":"streamable-http","additionalInterfaces":[{"url":"https://api.retraceai.tech/mcp","transport":"streamable-http"},{"url":"https://api.retraceai.tech/mcp/docs","transport":"streamable-http"},{"url":"https://api.retraceai.tech/api/v1","transport":"http+json"}],"version":"1.0.0","provider":{"organization":"Retrace","url":"https://retraceai.tech"},"iconUrl":"https://retraceai.tech/icons/icon-512.png","documentationUrl":"https://docs.retraceai.tech","capabilities":{"streaming":true,"pushNotifications":true,"stateTransitionHistory":true},"defaultInputModes":["application/json","text/plain"],"defaultOutputModes":["application/json","text/plain","text/markdown"],"securitySchemes":{"RetraceBearer":{"type":"http","scheme":"bearer","bearerFormat":"Retrace API key (rt_ prefix) or Better Auth session JWT","description":"Send Authorization: Bearer rt_.... Obtain a credential by following https://retraceai.tech/auth.md; protected-resource metadata is at https://api.retraceai.tech/.well-known/oauth-protected-resource."},"RetraceApiKey":{"type":"apiKey","in":"header","name":"x-retrace-key","description":"Retrace API key beginning with rt_."}},"security":[{"RetraceBearer":[]},{"RetraceApiKey":[]}],"supportsAuthenticatedExtendedCard":false,"skills":[{"id":"record-agent-run","name":"record-agent-run","description":"Record an AI agent execution as a trace: every model call, tool call, retrieval, and error is captured as a span with its input, output, cost, and timing.","tags":["sdk","read-only"],"examples":["record this agent execution so I can replay it later","instrument my Python agent so every model call is captured"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"inspect-trace","name":"inspect-trace","description":"Read a recorded agent execution and walk its span tree to find the first step that failed, drifted, or produced an ungrounded answer.","tags":["rest","read-only"],"examples":["show me the span where this agent run failed","walk the execution tree for trace 6f2c… and find the first error"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"search-spans","name":"search-spans","description":"Semantic search across recorded spans and agent memories to find prior occurrences of a behavior, prompt, or failure by meaning rather than exact text.","tags":["rest","read-only"],"examples":["have I seen this hallucination before in any recorded run","find previous runs where the agent looped on the same tool"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"fork-and-replay","name":"fork-and-replay","description":"Branch a recorded execution at one span with a modified input, then cascade-replay every downstream step so the whole agent re-executes along the new path. Side-effecting: requires explicit user approval before invocation.","tags":["rest","side-effecting"],"examples":["fork this run at step 3 with a shorter prompt and re-execute the rest","re-run the agent from the retrieval step using a different model"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"prove-the-fix","name":"prove-the-fix","description":"Re-run a failed execution after a change and return a verdict — improved, regressed, or unchanged — with the first divergent span. Side-effecting: requires explicit user approval before invocation.","tags":["rest","side-effecting"],"examples":["did my prompt change actually fix this failure","re-run the failed trace and tell me if it improved or regressed"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"evaluate-and-gate","name":"evaluate-and-gate","description":"Score recorded executions against behavioral criteria and return a pass/fail gate decision for a CI/CD pipeline.","tags":["rest","read-only"],"examples":["score these runs against my criteria and fail the build if they regress","run the CI evaluation gate for this deployment"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"enforce-budget","name":"enforce-budget","description":"Ask before the next model or tool call whether it is allowed: returns allow, block, or hold based on cost budgets, loop detection, and latency ceilings.","tags":["rest","read-only"],"examples":["is this next tool call within the cost budget","should the agent be allowed to make this call"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"agent-memory","name":"agent-memory","description":"Store and semantically recall persistent facts, preferences, corrections, and patterns extracted from prior agent runs.","tags":["mcp","read-only"],"examples":["remember that this customer prefers metric units","what have I learned about this project from earlier runs"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"publish-tape","name":"publish-tape","description":"Publish a recorded execution as an interactive, shareable public URL so a human can replay it in a browser. Side-effecting: requires explicit user approval before invocation.","tags":["rest","side-effecting"],"examples":["publish this run as a shareable link for my teammate","make an interactive replay of this execution public"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]},{"id":"read-retrace-docs","name":"read-retrace-docs","description":"Search and read the Retrace documentation, SDK guides, CLI reference, and OpenAPI specification over MCP, without credentials.","tags":["mcp","read-only"],"examples":["how do I enable cascade fork replay","what are the Retrace rate limits"],"inputModes":["application/json"],"outputModes":["application/json","text/markdown"]}],"additionalMetadata":{"openapi":"https://retraceai.tech/openapi.json","apiCatalog":"https://retraceai.tech/.well-known/api-catalog","aiCatalog":"https://retraceai.tech/.well-known/ai-catalog.json","agentSkills":"https://retraceai.tech/.well-known/agent-skills/index.json","mcpServerCard":"https://retraceai.tech/.well-known/mcp/server-card.json","authSkill":"https://retraceai.tech/auth.md","protectedResourceMetadata":"https://api.retraceai.tech/.well-known/oauth-protected-resource","authorizationServerMetadata":"https://auth.retraceai.tech/.well-known/oauth-authorization-server","contact":"hello@retraceai.tech"}}