@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.

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