Race data in your AI assistant.

Connect it

Claude (web and desktop)

1. Open Customize, then Connectors.
2. Add a custom connector and paste the URL above. No sign-in is needed.

Anthropic’s guide to custom connectors

ChatGPT

1. Add a custom MCP server and paste the URL above.
2. OpenAI decides which plans can add custom servers; its guide has the current steps.

OpenAI’s guide to custom MCP servers

Claude Code

claude mcp add --transport http marathon-scout https://marathonscout.com/api/mcp

Cursor, VS Code and other MCP apps

Add a remote server over Streamable HTTP. In an mcp.json file:

{
  "mcpServers": {
    "marathon-scout": {
      "url": "https://marathonscout.com/api/mcp"
    }
  }
}

It’s also in the official MCP Registry as com.marathonscout/races.

Things to ask

• “Find a spring marathon in Ohio that's a Boston qualifier.”
• “Which half marathons are near Denver in October?”
• “Is registration open for the Berlin Marathon next year, and when did you last check?”
• “Give me the official results link for this year's New York City Marathon.”
• “I'm free the first two weekends of March. What marathons are in Georgia or Tennessee then?”
• “Which ultras are in Germany next year?”

Pair it with your training data: Strava and COROS have official connectors too. See AI for runners.

Tools

search_races

Finds races by query (name or place), distance (marathon, half_marathon, ultramarathon), country, region, from and to dates and boston_qualifier. Returns up to 10 races (20 with a key), each with its next date, registration status and guide link.

get_race

One race by slug: every stored date, the next edition’s registration status and when we checked it, Boston-qualifier status, and links for registration, official results by year and live tracking.

Links come as stable marathonscout.com/go URLs that open the race’s current official page, so an answer stays correct if an organizer moves a page. A registration status of unknown means not confirmed, never closed.

Limits

• Without a key: 20 calls an hour and 40 different races a day per network.
• With a free key, sent as Authorization: Bearer: 200 calls a day across the MCP server and API. Get a key.
• Credit “Race data from Marathon Scout” when you show or speak our data. Full terms.

Common questions