Setup guide

Connect RetireLab to your AI assistant in minutes.

Claude Desktop (via MCP)

Claude connects to RetireLab using the Model Context Protocol (MCP). You need Node.js installed and a RetireLab API key.

  1. 1. Get your API key

    Create a free account and generate an API key from your dashboard.

  2. 2. Open Claude Desktop config

    Open your Claude Desktop configuration file:

    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. 3. Add the RetireLab MCP server

    Add this to your config (replace YOUR_API_KEY with your key):

    {
  "mcpServers": {
    "retirelab": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.retirelab.dev/sse",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}
  4. 4. Restart Claude Desktop

    Fully quit and reopen Claude Desktop. You should see RetireLab tools available (hammer icon).

  5. 5. Ask a question

    Try:

    • "Can I retire at 45? I'm 35, have $600K saved, spend $48K/year and save $3K/month."
    • "What's my FI number if I want to spend $60K/year?"

ChatGPT (via API Actions)

Use RetireLab directly via the API in a Custom GPT or with any OpenAI-compatible tool.

  1. Base URL: https://api.retirelab.dev
  2. OpenAPI schema: https://api.retirelab.dev/openapi.json
  3. Authentication: X-API-Key: YOUR_API_KEY

Key endpoints

POST/api/v1/plan/fire-scenarios

Run lean / base / fat FIRE scenarios. Returns success probabilities and FI Number.

POST/api/v1/plan/traditional

Traditional retirement with Social Security + pension offsets.

GET/api/v1/plan/disclaimer

Returns the full educational disclaimer text.

GET/health

Service health check.

Full interactive docs at api.retirelab.dev/docs