Skip to content
MCP server

Marathon Scout

Search 2,000+ marathons, halves and ultras and read dates, entry status and results links

Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.4.0
Listing updated
3 days ago

About Marathon Scout

Marathon Scout is a free MCP server for sports data. It runs as a hosted remote server, so there is nothing to install locally.

Registration data is deliberately cautious. Status is reported only for the edition it applies to, with the time it was last checked, and unknown means not confirmed, never closed. Registration, results and tracking come as stable marathonscout.com/go links that open the race's current official page, so stored links keep working if an organizer moves a page. The tool descriptions steer assistants to send runners to official sources before they spend money.

Two read-only tools do the work: search_races filters by name, place, distance, date window and Boston qualifier, and get_race returns one race's dates, entry status and official links. Without a key the server allows 20 calls an hour and 40 different races a day per network; a free API key raises that to 200 calls a day and 20 a minute across API and MCP.

Terms ask for credit ("Race data from Marathon Scout"), forbid mirroring the directory, and limit caching to 24 hours. A matching REST API has two read-only endpoints and needs a key.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://marathonscout.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "races": {
      "url": "https://marathonscout.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "races": {
      "type": "http",
      "url": "https://marathonscout.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "races": {
      "serverUrl": "https://marathonscout.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "races": {
      "type": "http",
      "url": "https://marathonscout.com/api/mcp"
    }
  }
}

Tools this server provides (2)

Read directly from the server.

search_races
Use this when a runner wants to find or choose a race, or asks about a race by name, date or place. Finds marathons, half marathons and ultras worldwide by name, city, region, country, distance, date window, distance from a place or Boston-qualifier status ("a spring marathon in Ohio", "halves within 100 miles of Denver in October"). Returns up to 10 races per call (20 with an API key) with the ne
get_race
Use this when you already have a race's slug from search_races and need its full details, or want to compare up to 5 races side by side (pass slugs). Returns every stored date, the next edition's registration state and when it was checked, Boston-qualifier status, and links for registration, official results by year and live tracking (once confirmed). Links are stable marathonscout.com/go URLs tha

What it does

Race search
Filter by name, place, distance, date window and Boston qualifier.
Race detail
Dates, entry status and official links for a single race.
Checked status
Registration is tied to an edition and a last-checked time.
Stable links
go links redirect to the race's current official page.
Works without a key
20 calls an hour anonymously; free key for more.
REST API
The same data over two read-only endpoints.

Good for

  • Find spring marathons in a given region
  • Check whether registration is open for next year's edition
  • Find Boston qualifier races
  • Link a runner to official results and live tracking
  • Plan a race calendar with an assistant

Pricing

Free

Free read-only MCP; free API key with 200 calls a day

Prices change. Check marathonscout.com before you buy.

Marathon Scout FAQ

Do I need an API key?

Not for MCP. It allows 20 calls an hour without one; a free key lifts the limit to 200 a day.

What does unknown registration status mean?

It means not confirmed, never closed.

Can I copy the whole directory?

No. The terms forbid rebuilding or reselling a race directory and cap caching at 24 hours.

How many races are covered?

More than 2,000 marathons, half marathons and ultras.

Is Marathon Scout free?

Yes. Marathon Scout is free to use.

How do I add Marathon Scout to Claude Code?

Run this command in your terminal: claude mcp add --transport http races https://marathonscout.com/api/mcp

What are the best alternatives to Marathon Scout?

The closest alternatives to Marathon Scout are MaineMCP, Agent Bookability Index, Tap2Cal, Veseljko katalog usluga za proslave and 숏츠생성기 Free K-pop Shorts.

Alternatives to Marathon Scout

  1. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment
  2. NYC-area event vendor prices, areas and booking options sourced from vendor sites

    • 9 tools
    • Remote
    • Free
    • Events and entertainment
  3. Tap2Cal

    MCP server

    Create shareable add-to-calendar links and read RSVPs from your AI assistant

    Not checked yet
    • 9 tools
    • Remote
    • Free
    • Productivity
  4. Search Croatian wedding and party venues, bands, photographers and caterers

    • 5 tools
    • Remote
    • Free
    • Events and entertainment
  5. Free finished K-pop shorts with title, description and thumbnail for YouTube Shorts

    • 3 tools
    • Remote
    • Free
    • Design and media