Developer API & MCP
A free, public, read-only API for IRONMAN and IRONMAN 70.3 race intelligence — course guides, typical race-day weather (10-year climatology), fueling targets, World Championship (Kona) qualification results and times, and the 16-week IRONMAN 70.3 training plan. The same data also ships as an MCP server you can connect to Claude or ChatGPT.
MCP server (for AI assistants)
Add the metrica MCP server as a custom connector and your AI assistant can query race conditions, courses, fueling, and qualification data directly. Endpoint:
https://www.metrica.fit/api/mcpNew to this? The step-by-step connect guide walks through adding it to Claude or ChatGPT.
It speaks JSON-RPC 2.0 over HTTP (the MCP Streamable-HTTP transport), stateless: protocol versions 2024-11-05 through 2025-11-25 with the initialize handshake, and 2026-07-28 with per-request metadata and server/discover. The public tools are read-only (readOnlyHint: true), need no key or account, and return text plus structuredContent; get_training_plan also links an MCP Apps view (ui://metrica/training-plan-v1.html). Public tools:
list_races | List race guides — optional search, type (full / 70.3) and upcomingOnly filters. |
get_race | Course, typical weather, fueling and slots for one race. |
list_qualifying_events | Events with qualification results (optional search). |
get_qualification | Qualification results + qualifying times for an event. |
compute_fueling | Per-hour fueling targets for a race. |
get_course_gpx | GPX course files (swim/bike/run) for a race. |
get_training_plan | The 16-week IRONMAN 70.3 plan: by hoursPerWeek or level (lite / standard / plus), dated and course-adjusted for a 70.3 race or dated from a raceDate; one week or every session. Comes with an interactive plan view in clients that render MCP Apps. |
Signed-in tools
The same endpoint lists seven tools that work on the athlete’s own metrica plan. They need an OAuth 2.1 access token from metrica’s authorization server (PKCE S256; clients identify with a Client ID Metadata Document or dynamic registration), asked for lazily: a call without one gets 401 + WWW-Authenticate: Bearer resource_metadata=… (ChatGPT: an error result with _meta["mcp/www_authenticate"]), and a token without the needed scope gets 403 insufficient_scope. Discovery: https://www.metrica.fit/.well-known/oauth-protected-resource/api/mcp and https://www.metrica.fit/.well-known/oauth-authorization-server. Each tool declares its securitySchemes.
get_today | Today’s planned workouts, every step with its targets. | plan:read |
get_week | One Monday–Sunday week of the plan (defaults to this week). | plan:read |
get_training_status | Fitness, fatigue and form from the training-load engine. | plan:read |
get_goal_race | The goal race the plan builds to. | plan:read |
update_workout | Adjust a planned workout’s pace, power, heart rate, time or reps. | plan:write |
move_workout | Move a planned workout to another day. | plan:write |
push_workout_to_device | Send a planned workout to Garmin or Wahoo. | plan:write |
get_setup_status | What the account still needs for a plan (profile, race, season, week) and the next step. | plan:read |
get_profile | The athlete profile and benchmarks (FTP, threshold paces, heart rates, PRs). | profile:read |
update_profile | Set profile fields and benchmarks; only the fields given change. | profile:write |
list_my_races | The races on the athlete’s calendar and the goal (A) race. | plan:read |
add_my_race | Add an IRONMAN race by guide slug, or any race by name, date and distance. | plan:write |
remove_my_race | Remove a race from the calendar. | plan:write |
get_season | The season outline: every week’s phase, hours, focus and build status. | plan:read |
create_season | Map a season to the goal race: a preview with a confirm_token, then a background build. | plan:write |
generate_week | Build the current or next week’s workouts in the background. | plan:write |
get_plan_job | Status of a season, week, workout or day job (queued, running, done, failed). | plan:read |
build_workout | Build one workout on a date from a plain-text description, in the background. | plan:write |
remove_workout | Remove one planned workout from a day (preview, then confirm). | plan:write |
modify_day | Rework a whole day from feedback, intensity and sports, in the background. | plan:write |
clear_future_workouts | Clear the planned workouts from a date on (preview, then confirm). | plan:write |
get_recovery | One day’s WHOOP or Keely recovery, HRV, resting HR and sleep, with 14- and 30-day baselines. | health:read |
get_recovery_trend | Daily recovery and sleep between two dates (up to 90 days). | health:read |
get_training_load | The fitness, fatigue and form series with load ratio, monotony, strain and risk. | health:read |
get_activities | Completed sessions from Strava and Wahoo between two dates. | health:read |
get_week_review | One week of the plan next to what was completed, per day and discipline. | health:read |
get_connections | Which apps are connected and their latest data. | health:read |
log_checkin | Log muscle soreness or mental energy (1–5) when the athlete asks. | health:write |
log_food | Log food from plain text when the athlete asks (Pro). | health:write |
REST API
Base URL https://www.metrica.fit/api/public · JSON · CORS-enabled · no key required.
GET /api/public/races | All published IRONMAN/70.3 race guides (slug, name, type, date). |
GET /api/public/races/{slug} | One race guide: typical conditions, course distances/elevation, fueling, WC slots. |
GET /api/public/races/{slug}/gpx?discipline=swim|bike|run | Downloadable GPX course track (approximate, derived). Served to people, search engines and assistants fetching for a person; AI-training, SEO and unidentified crawlers get a 403 with attribution and contact details. |
GET /api/public/events?search= | Events that have World Championship qualification results. |
GET /api/public/qualification?event={slug|id}&ageGroup=&rolldown= | Who qualified, age-graded times, qualifying times, rolldown. |
GET /api/public/fueling?raceType=full|70.3&durationHours=&tempC=&bodyMassKg= | Per-hour carb / sodium / fluid targets. |
GET /api/public/fuel/products?format=gel|chew|drink_mix|bar|electrolyte | Verified endurance-fuel catalog: label facts per product (carbs, sources, ratio, sodium, caffeine…). |
GET /api/public/fuel/score?product={slug}&sport=run|bike|tri|trail|hike&hours=&intensity=easy|steady|race&temp=&mass= | Job-fit grade (A–E) + reasons for one product on one job, plus the per-hour targets. |
Training plan files
GET /plans/70-3.md | The 16-week 70.3 plan (about 10 h a week) as markdown. |
GET /races/{slug}/training-plan.md | The plan dated for one 70.3 race guide and adjusted for its course, as markdown. |
GET /races/{slug}/training-plan.ics?level=lite|standard|plus | That plan as a calendar file, one event per session. |
GET /plans/70-3.ics?date=YYYY-MM-DD&level=lite|standard|plus | The plan dated back from any race day, as a calendar file. |
GET /plans/70-3.pdf?level=… · /races/{slug}/training-plan.pdf?level=… | The plan as a printable PDF (undated, or dated for that race). |
Example
# Typical conditions + fueling for a race
curl https://www.metrica.fit/api/public/races/im703-nice
# Who qualified for the World Championship at an event
curl "https://www.metrica.fit/api/public/qualification?event=2026-ironman-703-westfriesland"
# The 70.3 plan for IRONMAN 70.3 Agadir at ~7 h a week, over MCP
curl -X POST https://www.metrica.fit/api/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_training_plan","arguments":{"race":"im703-agadir","hoursPerWeek":8}}}'Free for non-commercial use; please attribute metrica.fit and link back. Weather is a 10-year climatology (typical, not a forecast). Qualification is modelled with the WTC age-group multipliers — confirm against the official allocation. Not affiliated with or endorsed by the IRONMAN Group.