rundida-mcp
MCP server for running & fitness — AI agents compute paces, HR zones and race predictions, and query 300+ marathons + 99 calculators from RunDida.com. npx @rundida/mcp-server
Documentation
@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-serverCursor / 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
Frequently asked questions
What is rundida-mcp?
rundida-mcp is MCP server for running & fitness — AI agents compute paces, HR zones and race predictions, and query 300+ marathons + 99 calculators from RunDida.com. npx @rundida/mcp-server
How do I install rundida-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is rundida-mcp open source?
Yes — it is hosted on GitHub at https://github.com/XWeaponX7/rundida-mcp and has 1 stars.
Related MCP tools
Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Open-source coding agent memory. Records issues, attempts, fixes and decisions, then warns your agent before it repeats an approach that already failed. Native MCP server for Claude Code, Cursor, Antigravity and Codex. 100% local, no cloud, no telemetry. MIT.
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.
The go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.
AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP