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
claude mcp add --transport http hamrun https://hamrun--hamrun.run.toolsWhat 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.toolsPlatform CLI: remote server
codex mcp add hamrun --url https://hamrun--hamrun.run.toolsConfig file
{
"mcpServers": {
"hamrun": {
"url": "https://hamrun--hamrun.run.tools"
}
}
}Config file
{
"servers": {
"hamrun": {
"type": "http",
"url": "https://hamrun--hamrun.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http hamrun https://hamrun--hamrun.run.toolsStep 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.