XWeaponX7/rundida-mcp
π βοΈ - 86 running calculators, 29 marathon events, pace/time/distance calculations, race time predictions (Riegel formula), and heart rate training zones (Karvonen method) for AI agents. No API key required.
Quick Install
{
"mcpServers": {
"xweaponx7-rundida-mcp": {
"command": "npx",
"args": [
"-y",
"xweaponx7-rundida-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
@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