# Marathon Scout

> Marathon Scout is a free MCP server for sports data. Search 2,000+ marathons, halves and ultras and read dates, entry status and results links. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://marathonscout.com/developers
- **MCP Registry name:** com.marathonscout/races
- **Categories:** sports data, events and entertainment
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://marathonscout.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "races": {
      "url": "https://marathonscout.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Last.fm MCP](https://ai-powered.com/mcp/last-fm-mcp): Last.fm MCP is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/marathon-scout
