# ham.run

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2509 installs
- Author: hamrun
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/hamrun/hamrun
- Updated: 2026-05-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hamrun

## What it 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.

## Requirements
- Remote server: `https://hamrun--hamrun.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hamrun https://hamrun--hamrun.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hamrun --url https://hamrun--hamrun.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hamrun": {
            "url": "https://hamrun--hamrun.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hamrun": {
            "type": "http",
            "url": "https://hamrun--hamrun.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hamrun https://hamrun--hamrun.run.tools
```

## When to use it
- 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
- 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

## Similar
- [running-race-coach](https://affpapa.org/en/nevibecode/plugins/running-race-coach.md) — plugin · ★ 35 repo stars
- [Run Coach](https://affpapa.org/en/nevibecode/mcp/run-coach.md) — MCP server · ★ 17 repo stars
- [Long Run Hybrid Coach](https://affpapa.org/en/nevibecode/mcp/long-run-hybrid-coach.md) — MCP server · ★ 7 repo stars
- [chirona](https://affpapa.org/en/nevibecode/mcp/chirona.md) — MCP server · 129 installs
- [Garmin Connect (treinos)](https://affpapa.org/en/nevibecode/mcp/garmin-connect-treinos.md) — MCP server · 264 installs
- [livedot MCP](https://affpapa.org/en/nevibecode/mcp/livedot-mcp.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
