# running.services Race Search

> running.services Race Search is a freemium MCP server for maps and travel. Find upcoming US running races by name, city, state, distance and date. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://running.services/developers
- **Repository:** https://github.com/biserd/running-directory
- **MCP Registry name:** io.github.biserd/running-directory
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

One tool, search_races, searches the race calendar behind running.services and returns up to ten results with links to each race page. It covers United States races only. The site's README says the calendar draws on the RunSignUp API and lists more than 17,000 races across all 50 states.

Discovery and search need no account or key; Cloudflare applies a limit of 30 MCP requests per minute per IP at each edge location. A separate partner REST API adds filters such as surface, Turkey Trot, Boston qualifier, walker-friendly and stroller-friendly, plus per-race scores for beginner, PR, value, vibe, family and quality. That API uses an X-API-Key header and monthly metering, with a free tier of 1,000 requests a month, a Growth tier of 10,000 and a Pro tier of 50,000.

The site makes money from organizer analytics, market reports, API access and labelled brand sponsorships. The race calendar and scoring tools stay free for runners. Payments for paid products are handled by hand for now.

## Features

- **Race search:** Looks up races by name or city, state, distance and date.
- **Page links:** Each of up to 10 results links to its running.services race page.
- **No key for search:** MCP discovery and search work without an account.
- **Partner REST API:** Adds filters, pagination, full race detail and featured slots under monthly metering.
- **Fit scores:** The API returns beginner, PR, value, vibe, family and quality scores per race.

## Good for

- Find a 5K near a city on a given weekend
- List Thanksgiving Turkey Trots in a state
- Shortlist half marathons by distance and month
- Feed a club newsletter with upcoming local races

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http running-directory https://running.services/mcp
```

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

```sh
https://running.services/mcp
```

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

```json
{
  "mcpServers": {
    "running-directory": {
      "url": "https://running.services/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "running-directory": {
      "type": "http",
      "url": "https://running.services/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "running-directory": {
      "serverUrl": "https://running.services/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "running-directory": {
      "type": "http",
      "url": "https://running.services/mcp"
    }
  }
}
```

## Tools

- `search_races`: Search public US race listings by name or city, state, distance, and date. Returns basic race details and links to running.services, sorted by date.

## FAQ

### Which races does it cover?

Upcoming races in the United States.

### Do I need an API key?

Not for MCP search. The REST API uses an X-API-Key header.

### What are the limits?

MCP is capped at 30 requests per minute per IP; REST has monthly caps of 1,000, 10,000 or 50,000 requests by tier.

### How many results come back?

Up to 10 per search.

### Is running.services Race Search free?

running.services Race Search has a free plan, with paid plans for more usage or features.

### How do I add running.services Race Search to Claude Code?

Run this command in your terminal: claude mcp add --transport http running-directory https://running.services/mcp

### What are the best alternatives to running.services Race Search?

The closest alternatives to running.services Race Search are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [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.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/running-services-race-search
