{
  "markdown": "# @rundida/mcp-server\n\nMCP server for [**RunDida**](https://rundida.com) — running expertise for AI agents.\n\nTen 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.\n\n[![Website](https://img.shields.io/badge/RunDida.com-99%20Running%20Tools-blue)](https://rundida.com)\n[![npm](https://img.shields.io/npm/v/@rundida/mcp-server)](https://www.npmjs.com/package/@rundida/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"rundida\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@rundida/mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add rundida -- npx -y @rundida/mcp-server\n```\n\n### Cursor / Windsurf\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"rundida\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@rundida/mcp-server\"]\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Type | Description |\n|------|------|-------------|\n| `list_tools` | Data | Browse all [99 running calculators](https://rundida.com) with descriptions |\n| `get_tool` | Data | Get details, FAQs, and sources for a specific tool |\n| `list_guides` | Data | Browse all [46 running guides](https://rundida.com/guide/) with descriptions |\n| `get_guide` | Data | Get guide details, FAQs, and related tools |\n| `list_marathons` | Data | List [300+ marathon events](https://rundida.com/marathon/) with dates and locations |\n| `get_marathon` | Data | Get marathon details including weather and course profile |\n| `calculate_pace` | Compute | Calculate pace, time, or distance (provide any 2 of 3) |\n| `predict_race` | Compute | Predict race times using Riegel formula + VO2max estimation |\n| `heart_rate_zones` | Compute | Calculate 5 HR training zones (Karvonen method) |\n| `marathon_countdown` | Compute | Get countdown to a specific marathon event |\n\n**Data tools** fetch from the [RunDida API](https://rundida.com/api/) with 30-minute caching. **Compute tools** run locally with zero latency — no API calls needed.\n\n## Example Usage\n\nAsk your AI assistant:\n\n- \"What's my marathon pace if I want to finish in 3:30?\"\n- \"Predict my marathon time based on my 10K of 45 minutes\"\n- \"What are my heart rate zones? I'm 32 with a resting HR of 52\"\n- \"How many days until the Tokyo Marathon?\"\n- \"Show me all running calculators related to nutrition\"\n- \"What running guides do you have about marathon training?\"\n- \"Tell me about the couch to 5K guide\"\n\n## About RunDida\n\n[**RunDida**](https://rundida.com) (跑滴答) is a free running tools platform for runners of all levels:\n\n- **[90+ Interactive Calculators](https://rundida.com)** — Pace, heart rate zones, VO2max, race prediction, nutrition, gear sizing, weather impact, and more\n- **[29 Marathon Countdowns](https://rundida.com/marathon/)** — Live timers with race-day weather forecasts, course profiles, and training tools\n- **[Free JSON API](https://rundida.com/api/)** — No authentication required, CORS enabled, [OpenAPI 3.0 documented](https://rundida.com/api/openapi.json)\n- **Multi-language** — English, Chinese (中文)\n- **Embeddable Widgets** — One-line iframe embed for any calculator\n\nAll tools are free, no account required. Try them at [rundida.com](https://rundida.com).\n\n## How It Works\n\nThe computation tools use established running science formulas:\n\n| Formula | Used In | Description |\n|---------|---------|-------------|\n| **Riegel formula** | `predict_race` | Race time prediction across distances |\n| **Jack Daniels method** | `predict_race` | VO2max estimation from race performance |\n| **Karvonen method** | `heart_rate_zones` | Heart rate training zones from age and resting HR |\n\n## Requirements\n\n- Node.js >= 18\n- Internet connection (data tools fetch from [rundida.com](https://rundida.com))\n\n## Links\n\n| Resource | URL |\n|----------|-----|\n| **RunDida Website** | [rundida.com](https://rundida.com) |\n| **API Documentation** | [rundida.com/api](https://rundida.com/api/) |\n| **OpenAPI Spec** | [rundida.com/api/openapi.json](https://rundida.com/api/openapi.json) |\n| **NPM Package** | [@rundida/mcp-server](https://www.npmjs.com/package/@rundida/mcp-server) |\n\n## License\n\nMIT\n",
  "bytes": 4461,
  "sha": "e2a4e33e331c9dd0a68e6e82041c59be6032163d3f6866543ba9b49feef02bd2",
  "repo_slug": "xweaponx7/rundida-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xweaponx7_rundida_mcp_4c956bf0/readme"
}