Analytics
ham.run
Provides endurance sports performance modeling and analytics tools for race time prediction, fueling, pacing, and running economy.
ENDPOINT 1
https://mcp.ham.run/mcp
MCP server metadata
- Name
- ham-run
- Version
- 0.1.0
Marathon physiology calculations from ham.run: race prediction, fueling, pacing strategy, caffeine PK, running economy, periodization, heat acclimation, and grade-adjusted pace. All tools are pure calculations — no athlete profile is stored.
Known tools 13
predict_race_timePredict times across 5K / 10K / Half / Marathon from a known race result, using a distance-varying Riegel exponent (1.06 up to 10K, 1.07 to the half, 1.08 to the marathon) and age-graded performance scores against world records.
Inferred read-onlyfueling_planCompute substrate partitioning (CHO/fat oxidation), required carb intake rate, and predicted time-to-glycogen-depletion for an endurance effort.
Inferred read-onlypacing_strategySimulate marathon HR drift and fluid/sodium balance under given heat, sweat, and aid-station conditions.
Inferred read-onlycaffeine_protocolModel caffeine (and optional nicotine) blood concentration, performance gain, and side-effect curves over a race using a 1-compartment oral PK model.
Inferred read-onlyrunning_economyCompute oxygen cost of running (Cr in mL O₂·kg⁻¹·m⁻¹) given pace, gradient, surface, shoe type, and athlete characteristics.
Inferred read-onlyperiodization_compareForecast race-time progression across pyramidal, polarized, and threshold periodization models for a given weekly volume and starting marathon time.
Inferred read-onlyheat_acclimation_planPredict plasma volume expansion, VO₂max gain, race-time improvement, growth-hormone response, and overtraining risk for a sauna heat-acclimation protocol.
Inferred read-onlygap_paceDistribute a goal time across a course profile in proportion to each segment's Minetti gradient cost.
Inferred read-onlygenerate_training_planBuild a concrete marathon training schedule from a periodization model: per-week sessions (long run, intervals, tempo, easy runs) with distances and prescribed paces derived from current fitness via the Riegel power law.
Inferred read-onlygenerate_workoutProduce one concrete running session from the desired stimulus (recovery, endurance, marathon pace, threshold, VO2max, speed, or mixed) and training phase, scaled to fitness anchored by any recent race time via the Riegel power law.
Inferred read-onlyget_my_athleteReturns the signed-in athlete's profile (age, sex, weight, VO₂max, marathon PR, biomechanics) plus derived HR zones.
Inferred read-onlyget_recent_activitiesList the signed-in athlete's recent activities with date, distance, duration, pace, average HR, and HR-zone classification.
Inferred read-onlyget_training_loadReturn per-week distance, time-in-zone, and rolling chronic/acute training load (CTL, ATL, TSB) for the signed-in athlete.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.ham-run]
url = "https://mcp.ham.run/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"ham-run": {
"type": "http",
"url": "https://mcp.ham.run/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: ham-run
Remote MCP URL: https://mcp.ham.run/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"ham-run": {
"url": "https://mcp.ham.run/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"ham-run": {
"type": "http",
"url": "https://mcp.ham.run/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "ham-run",
"transport": "streamable-http",
"url": "https://mcp.ham.run/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.