raceIQ in your AI tool

raceIQ has an MCP server, so Claude, ChatGPT, Cursor and other AI tools can search US running races, typical finish times and past results, and, once you sign in, tell you where you’d place using your target paces.

Server address

Add raceIQ to your tool as a remote MCP server (Streamable HTTP) with this URL:

https://raceiq.run/mcp

Race search, race details and finish times work right away, without an account. The first time you ask something that needs your account (your chances, recommendations, saved races or individual results), your tool opens a raceIQ page where you log in (or create a free account) and allow access. No API key to copy.

Set it up

Claude Code

claude mcp add --transport http raceiq https://raceiq.run/mcp

Claude Code asks you to sign in when a question needs your account. You can also sign in ahead of time: run /mcp, pick raceiq and choose Authenticate.

Claude (web and desktop)

Settings → Connectors → Add custom connector. Name it raceIQ and paste the URL above. Connect and allow access on raceIQ when asked.

ChatGPT

Add a custom connector (MCP server) from ChatGPT’s settings. Depending on your plan this may need developer mode. Use the URL above with OAuth authentication.

Cursor

In ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "raceiq": {
      "url": "https://raceiq.run/mcp"
    }
  }
}

VS Code

In .vscode/mcp.json, then start the server from the file and sign in when asked:

{
  "servers": {
    "raceiq": {
      "type": "http",
      "url": "https://raceiq.run/mcp"
    }
  }
}

Other tools

Any client that supports remote MCP servers works for the public tools. For the personal ones it also needs OAuth support, which it discovers from the server.

Things to ask

Find races

“Which upcoming 10Ks near me would I place best in?”
“Find half marathons within 60 miles of my places this spring, sorted by how I'd place.”
“What are the most competitive marathons near me next year?”

Your chances

“How would I place at my next saved race, and how hot is it likely to be?”
“Compare my chances at the races I've saved and tell me which one to target.”
“Which recent races near me would I have won my age group in?”

Times and results

“Is a 24:30 5K good for my age and gender?”
“Show the top 10 finishers in my age group at last year's edition of my next saved race.”
“What finish time would put me in the top 10% of half marathoners near me?”

Plan

“Build me a race calendar for next year: one goal race per season where I can podium.”
“Find a fast, flat-looking spring 10K I could win my age group in, and save it for me.”

Recommendations and chances need target paces. Set them on your account page, and save a place or two so “near me” means something.

Tools

Public: no account needed

`search_races`	Races by name, city (and radius), state, distance and date, soonest first.
`get_race`	A race series: dates, distances, typical finish times, field strength, finishers per year, race-morning weather, nearby races.
`get_finish_times`	Finish-time percentiles at 5K, 10K, half, marathon or mile, by gender and age group, nationally or near a city, and what share of finishers a time beats.

Personal: after you sign in

`get_my_profile`	Your target paces, units, age group and saved places.
`find_races_for_me`	Upcoming races near your places, ranked by where you'd likely place in your age group.
`recent_races_for_me`	Recent races near you and where you would have placed.
`get_my_chances`	Your expected placing in one race, its field strength and race-day heat.
`get_race_results`	Finishing times of a past race, without runners' names: age, gender, time, pace, home state.
`get_race_result_stats`	A past race's finish-time distribution by gender and age group.
`list_saved_races`	The races you saved.
`save_race`	Save or unsave a race.

Distances are in kilometers, paces in seconds per kilometer and durations in seconds unless a field says otherwise. Race slugs match raceiq.run/race/… URLs.

Access and privacy

A connected tool acts as you, with the access listed on the consent page: it reads races, results and your recommendations, and can save races. It can’t change your email, password, paces or settings. raceIQ hasn’t verified the names apps give themselves, so only allow an app you just started connecting.

See and disconnect connected tools under AI tools on your account page. Resetting your password disconnects all of them. What you ask your AI tool is handled by that tool’s provider under its own privacy policy; raceIQ sees only the tool calls it makes.

For developers

Transport: Streamable HTTP, stateless, at /mcp. Requests without a token are served, and every tool is listed; calling a tool marked “Needs sign-in” without a token answers HTTP 401 with a WWW-Authenticate challenge, so the client signs in and retries. Authorization follows the MCP authorization spec:

Protected resource metadata: https://raceiq.run/.well-known/oauth-protected-resource/mcp
Authorization server metadata: https://raceiq.run/.well-known/oauth-authorization-server
Dynamic client registration at /oauth/register (public clients, or a client secret if you register for one)
Authorization code with PKCE (S256 only), scope raceiq, resource https://raceiq.run/mcp
Access tokens last an hour; refresh tokens rotate on use and last 30 days. Revocation at /oauth/revoke.