Skip to main content
MCP server CX Codex

ham.run — Claude Code MCP server: what it does, how to install

ham.run is an MCP server that calculates marathon forecasts, pacing and fueling plans; Strava access adds the athlete's training data and load.

no license 2,509 installs updated 2026-05-15

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http hamrun https://hamrun--hamrun.run.tools
Open on GitHub

What ham.run does

The server covers endurance calculations. Race times are forecast from a known result using the Riegel exponent 1.06, age-graded against IAAF world records. Pacing simulation follows heart-rate drift, fluid and sodium balance across a marathon, down to the kilometre where LT₂ breaks. Fueling returns carb and fat oxidation plus the point of glycogen depletion; caffeine runs through a one-compartment oral PK model, with optional nicotine.

Transport is plain HTTP at https://hamrun--hamrun.run.tools. Stateless calculators answer without an account. get_my_athlete, get_recent_activities and get_training_load sign in through Strava. Add useMyData: true and weight, VO₂max, resting HR and age get pulled from that profile into the formulas.

Training load leans on heart rate: TSS is estimated by clamping avg_hr against threshold_hr. Good for direction over several weeks, wrong tool for comparing against power-based TSS. Every model carries a citation, among them Barnes & Kilding 2015, Minetti 2002, Scoon 2007 and Kirby 2021.

What it helps with

  • forecast a marathon from a recent 10K result
  • split a goal time across a hilly course kilometre by kilometre
  • set hourly carb intake and find the glycogen wall
  • model caffeine levels and side effects for race morning
  • compare pyramidal, polarized and threshold blocks at a fixed weekly volume

Example prompts for the agent

  • Forecast my marathon from a 38:20 10K, keep the default Riegel exponent
  • Spread a 3:15 goal over the course profile and show grade per kilometre
  • Pull my last week of activities and tell me if I overcooked it

How to install ham.run

Platform CLI: remote server

claude mcp add --transport http hamrun https://hamrun--hamrun.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about ham.run

How do I install ham.run in Claude Code?

Run claude mcp add --transport http hamrun https://hamrun--hamrun.run.tools. The server is added over HTTP and needs no key.

What does ham.run do?

It runs marathon physiology models: race-time prediction, pacing and fluid simulation, fueling, caffeine protocols, plus grade-adjusted splits. Three tools read the athlete's Strava profile and activities.

Do I need a Strava account?

Only for get_my_athlete, get_recent_activities and get_training_load. The stateless calculators work without signing in.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open