@rundida/mcp-server

MCP server for RunDida — running expertise for AI agents.

Ten tools that let Claude, Cursor or any MCP client compute paces, heart-rate zones, race predictions and marathon countdowns live, and query RunDida's full library: 99 running calculators, 56 training guides and 300+ marathon events (course, weather and registration data) — in English, Chinese and Japanese. Free, zero-config, no API key.

Website npm License: MIT

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rundida": {
      "command": "npx",
      "args": ["-y", "@rundida/mcp-server"]
    }
  }
}

Claude Code

claude mcp add rundida -- npx -y @rundida/mcp-server

Cursor / Windsurf

Add to your MCP configuration:

{
  "rundida": {
    "command": "npx",
    "args": ["-y", "@rundida/mcp-server"]
  }
}

Available Tools

Tool	Type	Description
`list_tools`	Data	Browse all 99 running calculators with descriptions
`get_tool`	Data	Get details, FAQs, and sources for a specific tool
`list_guides`	Data	Browse all 46 running guides with descriptions
`get_guide`	Data	Get guide details, FAQs, and related tools
`list_marathons`	Data	List 300+ marathon events with dates and locations
`get_marathon`	Data	Get marathon details including weather and course profile
`calculate_pace`	Compute	Calculate pace, time, or distance (provide any 2 of 3)
`predict_race`	Compute	Predict race times using Riegel formula + VO2max estimation
`heart_rate_zones`	Compute	Calculate 5 HR training zones (Karvonen method)
`marathon_countdown`	Compute	Get countdown to a specific marathon event

Data tools fetch from the RunDida API with 30-minute caching. Compute tools run locally with zero latency — no API calls needed.

Example Usage

Ask your AI assistant:

"What's my marathon pace if I want to finish in 3:30?"
"Predict my marathon time based on my 10K of 45 minutes"
"What are my heart rate zones? I'm 32 with a resting HR of 52"
"How many days until the Tokyo Marathon?"
"Show me all running calculators related to nutrition"
"What running guides do you have about marathon training?"
"Tell me about the couch to 5K guide"

About RunDida

RunDida (跑滴答) is a free running tools platform for runners of all levels:

90+ Interactive Calculators — Pace, heart rate zones, VO2max, race prediction, nutrition, gear sizing, weather impact, and more
29 Marathon Countdowns — Live timers with race-day weather forecasts, course profiles, and training tools
Free JSON API — No authentication required, CORS enabled, OpenAPI 3.0 documented
Multi-language — English, Chinese (中文)
Embeddable Widgets — One-line iframe embed for any calculator

All tools are free, no account required. Try them at rundida.com.

How It Works

The computation tools use established running science formulas:

Formula	Used In	Description
Riegel formula	`predict_race`	Race time prediction across distances
Jack Daniels method	`predict_race`	VO2max estimation from race performance
Karvonen method	`heart_rate_zones`	Heart rate training zones from age and resting HR

Requirements

Node.js >= 18
Internet connection (data tools fetch from rundida.com)

Links

Resource	URL
RunDida Website	rundida.com
API Documentation	rundida.com/api
OpenAPI Spec	rundida.com/api/openapi.json
NPM Package	@rundida/mcp-server

License

MIT

rundida-mcp