---
title: "MCP Server — Retrace"
description: "Retrace hosted MCP server with Streamable HTTP transport, server-card discovery, API-key authentication, and trace debugging tools."
canonical: "https://retraceai.tech/developers/mcp-server"
last-updated: 2026-08-26
format: text/markdown
---

# MCP Server

Connect Claude, Codex, Cursor, Windsurf, and other MCP clients to recorded traces, semantic search, memory, fork replay, and shareable tapes.

## What it does

- **Streamable HTTP** — The hosted endpoint uses the MCP Streamable HTTP transport at api.retraceai.tech/mcp.
- **Automatic discovery** — An AI Catalog on retraceai.tech points clients to a schema-valid MCP Server Card next to the endpoint.
- **Trace and memory tools** — Agents can list and inspect traces, search spans, store and recall memories, and retrieve public tapes.
- **Explicit mutation approval** — Replay and publishing tools require explicit user confirmation because they can spend quota or expose data.

## Examples

Configure any Streamable HTTP MCP client.

```mcp.json
{
  "mcpServers": {
    "retrace": {
      "url": "https://api.retraceai.tech/mcp",
      "headers": { "Authorization": "Bearer rt_..." }
    }
  }
}
```


## Discovery and connection URLs

- `https://retraceai.tech/.well-known/ai-catalog.json — domain discovery`
- `https://api.retraceai.tech/mcp/server-card — MCP Server Card`
- `https://api.retraceai.tech/mcp — Streamable HTTP endpoint`
- `https://docs.retraceai.tech/mcp-server — complete tool reference`

## Related

- HTML page: https://retraceai.tech/developers/mcp-server
- Documentation: https://docs.retraceai.tech
- OpenAPI specification: https://retraceai.tech/openapi.json
- Authentication for agents: https://retraceai.tech/auth.md