New

Connect MyRace to Claude

Ask Claude about any race or athlete in MyRace. Get answers, leaderboards, and interactive elevation charts right in the conversation.

What you can ask

  • "What races are in MyRace?"
  • "Show me the elevation profile for the 2025 California International Marathon" — renders an interactive elevation chart
  • "What's the course terrain like at the Broken Arrow Skyrace 46K?"
  • "Show me the top finishers at the 2024 California International Marathon" — pops up an interactive leaderboard you can page through and filter by gender or athlete name
  • "How did Angelo Matheou do at the 2023 California International Marathon?" — renders an interactive result card with pacing chart, splits on hover, and qualifying badges

Just use race names in plain English — Claude looks up the matching race automatically. If a race isn't in MyRace yet, it'll tell you and suggest similar ones.

Setup (about 30 seconds)

Requires Claude Pro, Max, or Team. Custom connectors aren't available on the free plan.

  1. 1
    Open Claude settings
    Go to claude.ai/settings/connectors (or in Claude Desktop, Settings → Connectors).
  2. 2
    Add a custom connector
    Click Add custom connector.
  3. 3
    Paste the MyRace URL
    https://mcp.myrace.ai/mcp

    Leave the Advanced settings (OAuth Client ID / Secret) blank.

  4. 4
    Connect
    Click Connect. The connector will appear with a green checkmark once it's reachable.
  5. 5
    Try it
    Start a new chat. Ask "Using MyRace, show me the elevation profile for the 2025 California International Marathon". Claude will call the tool and render an interactive chart inline. Or try "Show me the top finishers at the California International Marathon 2025" to see the interactive leaderboard with paging and gender/name filtering. Just use the race name in plain English — Claude looks up the matching race for you. The first time, you'll be asked to allow each tool; pick Always allow to silence the prompt.

Where it works

  • claude.ai (web) — full support including interactive charts
  • Claude Desktop (macOS & Windows) — same connector syncs automatically when you sign in with the same account
  • VS Code GitHub Copilot, Goose, Postman — also support MCP connectors

You only need to add the connector once per Anthropic account; it syncs across web and desktop automatically.

Using a different MCP client?

The MyRace server works with any MCP-compatible client — Cursor, ChatGPT developer mode, VS Code GitHub Copilot, Goose, Postman, and others. See the client-neutral docs at myrace.ai/mcp.

What's covered

MyRace currently includes results from a growing list of California marathons, the Rocket City Marathon, the Shamrock Marathon, NYC Half, and a number of Sierra Nevada trail and ultra events (American River 50, Broken Arrow Skyrace, Jed Smith Ultra Classic, Rio Del Lago 100, Way Too Cool 50K, and more). The California International Marathon (CIM) is covered going back to 2018.

New races are added throughout the season — ask Claude to "list the available races" to see the latest set.

Troubleshooting

  • Connector won't connect: double-check the URL is exactly https://mcp.myrace.ai/mcp (with no trailing slash) and that your Anthropic plan is Pro, Max, or Team (custom connectors aren't available on Free).
  • Tools don't appear after connecting: click the connector in settings → Disconnect, then add it again. Claude refreshes the tool list on reconnect.
  • Inline cards don't render (you only see plain text): the interactive cards require a recent claude.ai or Claude Desktop build. Hard-refresh the browser (Cmd/Ctrl+Shift+R), or update Claude Desktop, then re-run the prompt.
  • "Tool failed" or empty result: usually a transient network blip. Retry the prompt. If it persists, the underlying race may not be in MyRace yet — ask Claude to "list the available races" to confirm.
  • Desktop ↔ web sync delay: after adding the connector on web, give the desktop app a few seconds and a fresh chat for the new connector to appear.

Privacy & data

Claude only fetches data from MyRace when you ask a question that requires it. The MCP server exposes the same race results that are public on this site — finish times, splits, rankings, and elevation profiles. Nothing private is shared with Claude or Anthropic.

  • Retention: the MCP server stores nothing per-request — no conversation data, no query logs beyond standard Vercel platform request logs.
  • Third-party sharing: the only outbound call is from get_athlete_insights, which proxies to MyRace's own AI endpoint; that endpoint streams Claude Sonnet via Anthropic's API. No data is shared with any other third party.
  • Contact: privacy@myrace.com for privacy or data-handling questions.

For reviewers

This connector is a candidate for the Claude Connector Directory. The endpoint is currently public read-only (no authentication required). It exposes only the publicly published race results already shown on myrace.ai (finisher names, hometowns, ages, and finish times); athletes who opt out are masked.

Endpoint: https://mcp.myrace.ai/mcp

Suggested test prompts (each exercises a different tool):

  • "What races are in MyRace?" — exercises list_races
  • "Show me the elevation profile for the 2025 California International Marathon" — exercises get_elevation_profile and renders the inline MCP App chart
  • "Tell me about the 2025 California International Marathon" — exercises get_race_info
  • "Who finished top 10 in the women's field at the 2025 California International Marathon?" — exercises get_race_results; renders as an interactive leaderboard with in-iframe pagination and gender/search filters via app.callServerTool (no LLM round-trip per page)
  • "Search for athletes named 'Smith' across all races" — exercises search_athletes
  • "How did Angelo Matheou perform at the 2023 California International Marathon?" — exercises get_athlete_result after a search-by-name lookup; renders as an inline result card with a pace-per-segment bar chart, pacing/halves/progression summary, and Boston/NYC qualification badges (when applicable)
  • "Give me extra coaching insights on Angelo Matheou's 2023 CIM segment-by-segment performance" — exercises get_athlete_insights (also surfaced inline inside the result card automatically)

Race names resolve via Claude calling list_races first — no need to know any race IDs. For deterministic testing, the underlying stable race IDs are cim_2025, cim_2024, rocket_city_2025, and bas_46k_2025. All 7 tools are read-only and declare annotations.readOnlyHint = true; none perform writes, transfers, or media generation.

Allowed link targets (for the directory submission form): the only origin used by app.openLink calls and tool-emitted markdown links is https://myrace.ai (HTTPS origin; no subdomains, no custom URI schemes).

Open Claude settings About MCP Apps