# Marathon Scout

> Find marathons, halves and ultras worldwide: checked dates, entry status, results and live tracking.

- name: com.marathonscout/races
- version: 1.4.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 96/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.marathonscout%2Fraces
- tools: https://api.protogrid.dev/v1/servers/com.marathonscout%2Fraces/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

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


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-3d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 96/100 (strong)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 3600000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 2 of 2 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,018 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 83 (weight 15)

- warn `stability.changes`: 8 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 2, about 1,018 tokens to load them all
- tool set hash: 9ee1362619e93a18c5ddfa6ceab73405
- tools last changed: 2026-11-11T03:28:24.819Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.marathonscout/races.svg)](https://protogrid.dev/servers/com.marathonscout/races)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-11 `get_race` changed (description)
  - before: One race, or up to 5 at once with slugs, by Marathon Scout slug (from search_races): 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 that open the current official page; official_url fields name the destination.
  - after: 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 that open the current official page; official_url fields name the destination. Each race counts toward the daily different-races limit. Limits without a key: 20 calls an hour and 40 different races a day; a free key from https://marathonscout.com/developers allows 200 calls and 150 different races a day.
- 2026-11-11 `search_races` changed (description, inputSchema)
  - before: Find races for a runner: 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 (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order; a near search with no dates comes back nearest first, each race with distance_miles. Pass looking_for to get registration, results or live tracking links in the same call instead of calling get_race for each race.
  - after: 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 next race date, registration status and Marathon Scout guide URL, plus total (every match) and next_offset (pass it as offset for the next page). With no text query, results are in date order; a near search with no dates comes back nearest first, each race with distance_miles. Pass looking_for to get registration, results or live tracking links in the same call instead of calling get_race for each race. Limits without a key: 20 calls an hour and 40 different races a day; a free key from https://marathonscout.com/developers allows 200 calls and 150 different races a day.
- 2026-11-10 `get_race` changed (description, inputSchema)
  - before: One race by its Marathon Scout slug (from search_races): 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 that open the current official page; official_url fields name the destination.
  - after: One race, or up to 5 at once with slugs, by Marathon Scout slug (from search_races): 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 that open the current official page; official_url fields name the destination.
- 2026-11-10 `search_races` changed (description, inputSchema)
  - before: Find races for a runner: marathons, half marathons and ultras worldwide by name, city, region, country, distance, date window or Boston-qualifier status ("a spring marathon in Ohio", "halves near Denver in October"). Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
  - after: Find races for a runner: 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 (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order; a near search with no dates comes back nearest first, each race with distance_miles. Pass looking_for to get registration, results or live tracking links in the same call instead of calling get_race for each race.
- 2026-11-09 `search_races` changed (description)
  - before: Find races for a runner: marathons, half marathons and ultras worldwide by name, city, region, country, distance, date window or Boston-qualifier status ("a flat spring marathon in Ohio", "halves near Denver in October"). Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
  - after: Find races for a runner: marathons, half marathons and ultras worldwide by name, city, region, country, distance, date window or Boston-qualifier status ("a spring marathon in Ohio", "halves near Denver in October"). Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
- 2026-11-07 `search_races` changed (description)
  - before: Find marathons, half marathons and ultras by name, city, region, country, distance, date window or Boston-qualifier status. Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
  - after: Find races for a runner: marathons, half marathons and ultras worldwide by name, city, region, country, distance, date window or Boston-qualifier status ("a flat spring marathon in Ohio", "halves near Denver in October"). Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
- 2026-11-06 `get_race` changed (description)
  - before: One race by its Marathon Scout slug (from search_races): every stored date, the registration state for the next edition with when it was last checked and the official registration link, the official website, live tracking when the race-week tracker is confirmed, official results links by year, and Boston-qualifier status.
  - after: One race by its Marathon Scout slug (from search_races): 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 that open the current official page; official_url fields name the destination.
- 2026-11-06 `search_races` changed (description, inputSchema)
  - before: Find marathons, half marathons and ultras by name, city, region, country, distance, date window or Boston-qualifier status. Returns up to 10 races (25 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.
  - after: Find marathons, half marathons and ultras by name, city, region, country, distance, date window or Boston-qualifier status. Returns up to 10 races (20 with an API key) with the next race date, registration status and Marathon Scout guide URL. With no text query, results are in date order.

Full history: https://api.protogrid.dev/v1/servers/com.marathonscout%2Fraces/changes

## Remotes

- https://marathonscout.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (2)

- `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 that open the current official page; official_url fields name the destination. Each race counts toward the daily different-races limit. Limits without a key: 20 calls an hour and 40 different races a day; a free key from https://marathonscout.com/developers allows 200 calls and 150 different races a day.
- `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 next race date, registration status and Marathon Scout guide URL, plus total (every match) and next_offset (pass it as offset for the next page). With no text query, results are in date order; a near search with no dates comes back nearest first, each race with distance_miles. Pass looking_for to get registration, results or live tracking links in the same call instead of calling get_race for each race. Limits without a key: 20 calls an hour and 40 different races a day; a free key from https://marathonscout.com/developers allows 200 calls and 150 different races a day.