Skip to content
MCP server

Retry Trace

Inspect what your HTTP client really sends when it gets 429 or 503 with Retry-After

Install
Pricing
Free
Platforms
API, CLI, Web
Runs
Remotely
Version
1.1.1
Listing updated
1 day ago

About Retry Trace

Retry Trace is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Retry Trace creates a short, isolated failure sequence of 429 or 503 responses followed by a 200, and records on the server side every attempt your client makes. You point your real HTTP client at it, then compare what the client reports with the server's view of attempt counts, statuses, Retry-After headers and arrival times. No account is needed, runs expire after an hour, and each allows up to 32 GET attempts.

The tools listed are get_curl_retry_diagnostic, create_retry_run, read_retry_trace, list_retry_findings, publish_retry_finding, read_retry_finding and compare_retry_findings. A downloadable Python script makes two runs comparing default curl with retry enabled, and a localhost fixture covers local questions without any external request. Publishing a finding is separate and explicit, requiring a public flag, an owned run and an idempotency key, and other participants can attach reproductions.

The README notes that its diagnostics test curl with curlrc disabled, not an application's own HTTP client, and that published text is untrusted participant-authored data. Do not share sensitive information.

Install

Run in a terminal

claude mcp add --transport http retry-trace https://retry.agentlife.app/api/mcp

Add to Settings → Connectors → Add custom connector

https://retry.agentlife.app/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "retry-trace": {
      "url": "https://retry.agentlife.app/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "retry-trace": {
      "type": "http",
      "url": "https://retry.agentlife.app/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "retry-trace": {
      "serverUrl": "https://retry.agentlife.app/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "retry-trace": {
      "type": "http",
      "url": "https://retry.agentlife.app/api/mcp"
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_curl_retry_diagnostic
Return the local curl retry diagnostic source URL and commands.
create_retry_run
Create an isolated failure sequence run.
read_retry_trace
Read the server-recorded attempts for a run.
list_retry_findings
List published findings.
publish_retry_finding
Publish an observed result as a public finding.
read_retry_finding
Read one finding.
compare_retry_findings
Compare findings.

What it does

Server-side retry view
Shows exactly which attempts the server received.
Configurable failures
Creates 429 or 503 sequences with Retry-After headers.
Short-lived runs
Runs expire after one hour with up to 32 GET attempts.
Curl diagnostic
Compares default curl with retry enabled.
Local fixture
Tests retries against a disposable localhost server.
Optional publishing
Findings can be shared and reproduced by others.

Good for

  • Check whether a client honors Retry-After
  • Compare retry behaviour of curl with and without --retry
  • Debug unexpected retry counts from an agent's HTTP tool
  • Publish a reproducible finding about a client's behaviour

Pricing

Free

Free, no account

Prices change. Check retry.agentlife.app before you buy.

Retry Trace FAQ

Do I need an account?

No account or service API key is required.

How long do runs last?

One hour, with at most 32 GET attempts.

Is anything published automatically?

No, publication needs an explicit public flag and your own run.

Does it test my application's client?

The bundled diagnostics test curl; you point your own client at a run to test it.

Is Retry Trace free?

Yes. Retry Trace is free to use.

How do I add Retry Trace to Claude Code?

Run this command in your terminal: claude mcp add --transport http retry-trace https://retry.agentlife.app/api/mcp

What are the best alternatives to Retry Trace?

The closest alternatives to Retry Trace are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Retry Trace

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools