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/mcp

New 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_racesList race guides — optional search, type (full / 70.3) and upcomingOnly filters.
get_raceCourse, typical weather, fueling and slots for one race.
list_qualifying_eventsEvents with qualification results (optional search).
get_qualificationQualification results + qualifying times for an event.
compute_fuelingPer-hour fueling targets for a race.
get_course_gpxGPX course files (swim/bike/run) for a race.
get_training_planThe 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_todayToday’s planned workouts, every step with its targets.plan:read
get_weekOne Monday–Sunday week of the plan (defaults to this week).plan:read
get_training_statusFitness, fatigue and form from the training-load engine.plan:read
get_goal_raceThe goal race the plan builds to.plan:read
update_workoutAdjust a planned workout’s pace, power, heart rate, time or reps.plan:write
move_workoutMove a planned workout to another day.plan:write
push_workout_to_deviceSend a planned workout to Garmin or Wahoo.plan:write
get_setup_statusWhat the account still needs for a plan (profile, race, season, week) and the next step.plan:read
get_profileThe athlete profile and benchmarks (FTP, threshold paces, heart rates, PRs).profile:read
update_profileSet profile fields and benchmarks; only the fields given change.profile:write
list_my_racesThe races on the athlete’s calendar and the goal (A) race.plan:read
add_my_raceAdd an IRONMAN race by guide slug, or any race by name, date and distance.plan:write
remove_my_raceRemove a race from the calendar.plan:write
get_seasonThe season outline: every week’s phase, hours, focus and build status.plan:read
create_seasonMap a season to the goal race: a preview with a confirm_token, then a background build.plan:write
generate_weekBuild the current or next week’s workouts in the background.plan:write
get_plan_jobStatus of a season, week, workout or day job (queued, running, done, failed).plan:read
build_workoutBuild one workout on a date from a plain-text description, in the background.plan:write
remove_workoutRemove one planned workout from a day (preview, then confirm).plan:write
modify_dayRework a whole day from feedback, intensity and sports, in the background.plan:write
clear_future_workoutsClear the planned workouts from a date on (preview, then confirm).plan:write
get_recoveryOne day’s WHOOP or Keely recovery, HRV, resting HR and sleep, with 14- and 30-day baselines.health:read
get_recovery_trendDaily recovery and sleep between two dates (up to 90 days).health:read
get_training_loadThe fitness, fatigue and form series with load ratio, monotony, strain and risk.health:read
get_activitiesCompleted sessions from Strava and Wahoo between two dates.health:read
get_week_reviewOne week of the plan next to what was completed, per day and discipline.health:read
get_connectionsWhich apps are connected and their latest data.health:read
log_checkinLog muscle soreness or mental energy (1–5) when the athlete asks.health:write
log_foodLog 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/racesAll 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|runDownloadable 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|electrolyteVerified 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.mdThe 16-week 70.3 plan (about 10 h a week) as markdown.
GET /races/{slug}/training-plan.mdThe plan dated for one 70.3 race guide and adjusted for its course, as markdown.
GET /races/{slug}/training-plan.ics?level=lite|standard|plusThat plan as a calendar file, one event per session.
GET /plans/70-3.ics?date=YYYY-MM-DD&level=lite|standard|plusThe 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.