AI & MCP access

Ask AI about market breadth using your Breadth subscription.

Connect a compatible AI client through OAuth—no API key to create or copy. Access is read-only and currently covers S&P 500 SMA20 snapshots and history.

Same-day

S&P 500 SMA20 data

Full history

No one-year cutoff

Secure

OAuth · 10 calls/min

Setup guide

Connect your AI client

Breadth is a hosted Streamable HTTP MCP server. There is no package, local process, or API key to install—register the server URL in your client, then complete OAuth in your browser.

Server URL

https://api.breadth.app/mcp

Use the API URL exactly as shown. The page you are reading is documentation, not the MCP endpoint.

  1. 1. Add the remote server

    Choose the client you use. Configuration is per user unless you place it in a project file.

    VS Code

    Install in VS Code

    Run MCP: Add Server and choose HTTP, or save this as .vscode/mcp.json:

    {
  "servers": {
    "breadth": {
      "type": "http",
      "url": "https://api.breadth.app/mcp"
    }
  }
}

    Cursor

    Save this as ~/.cursor/mcp.json, or use .cursor/mcp.json for one project:

    {
  "mcpServers": {
    "breadth": {
      "url": "https://api.breadth.app/mcp"
    }
  }
}

    Claude Code

    Add Breadth as a user-level HTTP server from your terminal:

    claude mcp add --transport http breadth https://api.breadth.app/mcp --scope user

    Run /mcp inside Claude Code to connect or clear authentication.

  2. 2. Start the server and authorize

    STEP 1

    Start

    Start or reconnect the Breadth server in your client.

    STEP 2

    Sign in

    Your browser opens the Breadth sign-in page.

    STEP 3

    Allow

    Review and allow read-only breadth:read access.

    STEP 4

    Return

    Go back to the client and confirm the tools are listed.

  3. 3. Ask a question

    Enable the Breadth tools in your client, then ask about S&P 500 SMA20 breadth. Tool calls are read-only and limited to 10 requests per minute.

Troubleshooting

  • • No browser window: restart the MCP server from the client.
  • • Authorization denied: confirm the signed-in account has an active subscription.
  • • Do not add Authorization headers, API keys, or VS Code input prompts.
  • • After reconnecting, check that the Breadth tools appear in the client tool list.

Client documentation: VS Code · Cursor · Claude Code

Try questions like

  • “What percentage of S&P 500 stocks are above SMA20?”
  • “Show the latest S&P 500 SMA20 breadth snapshot by sector.”
  • “How has TOTAL SMA20 breadth changed over the past month?”

Unlock AI access

All paid billing cycles include same-day data, full history, and MCP access.

View Plans