rundida-mcp

@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