Retirement Lab MCP Server

Connect an MCP-capable agent client — Claude Desktop, Cursor, Codex CLI, or another MCP client — to Retirement Lab and run hypothetical retirement projections, tax previews, and country comparisons from inside your tool. The MCP server is a thin adapter over the same authenticated REST routes the web app uses: same account, same tier, same daily caps, same simulation engine. It is not a separate product.

This is an authenticated surface today. There is no anonymous (no-bearer) access — every call runs as the signed-in user behind an API key, at that user’s account tier. Sign in to Retirement Lab, then open your account menu and choose MCP API keys to issue one.

Sign in & issue an API key

Tool catalog

• run_simulation — enqueue a hypothetical projection.
• run_sweep — enqueue a multi-value sweep.
• compare_countries — side-by-side country comparison sweep.
• sensitivity_sweep — single-variable sensitivity sweep.
• get_run_result — compact stored results for a run.
• wait_for_run — bounded polling for a run.
• create_share_link — create a share URL for a completed scenario.
• cancel_run — cancel a queued or running MCP-originated run.
• get_supported_inputs — list countries, tax regimes, and simulation modes.
• preview_exit_tax — synchronous proposed-relocation exit-tax preview.
• preview_conversion_tax — synchronous Roth conversion tax preview.

See the full MCP docs for request/response shapes, tier caps, and the funnel block every compute-bound tool returns.

Sample client config

Paste your issued token in place of ... and point RETIREMENTLAB_API_BASE at the host you are running against:

{
  "mcpServers": {
    "retirementlab": {
      "command": "python",
      "args": [
        "scripts/mcp_stdio_bridge.py"
      ],
      "env": {
        "RETIREMENTLAB_API_BASE": "https://retirementlab.app",
        "RETIREMENTLAB_MCP_TOKEN": "..."
      }
    }
  }
}