Rundida MCP logo

Rundida MCP

by XWeaponX7

Compute running metrics and query RunDida’s calculators, guides, and marathon data through MCP without an API key.

Install Rundida MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "xweaponx7-rundida-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rundida/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 10 tools correctly (28d ago).

Overview

XWeaponX7/rundida-mcp MCP server exposes RunDida’s running calculators, guides, marathon listings, and race-related computations to MCP clients. It provides local calculations for pace, race prediction, and Karvonen heart-rate zones, while data tools retrieve RunDida content with 30-minute caching. No API key or account is required, though data queries need an internet connection. Use it when an agent needs running plans, race calculations, training references, or marathon event details.

Use cases

  • Calculate a target pace for a planned finish time
  • Predict a marathon result from a previous 10K performance
  • Compute heart-rate training zones from age and resting heart rate
  • Browse marathon events and retrieve event countdowns
  • Find running guides and calculator references

Key features

  • Pace, time, and distance calculations
  • Riegel-based race predictions
  • Karvonen heart-rate zones
  • Marathon event listings and countdowns
  • Running guide and calculator discovery
  • No API key required

Tools10

What Rundida MCP lets your agent do. Expand a tool for its parameters.

Verified live~811 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @rundida/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads360Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed10Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Rundida MCP works

What XWeaponX7/rundida-mcp MCP server does

XWeaponX7/rundida-mcp MCP server connects MCP-compatible assistants to RunDida’s running resources. Its ten tools cover two main areas: retrieving reference data from RunDida and performing running calculations locally.

The data tools expose the available running calculators, guides, and marathon events. An agent can list resources, then request detailed information about a selected calculator, guide, or event. Tool and guide details may include FAQs and related resources. Marathon details include event information, dates, locations, countdown data, and the event data described by RunDida.

The calculation tools handle common training and race questions:

  • calculate_pace derives pace, finish time, or distance when any two of those values are supplied.
  • predict_race estimates a target-distance result from a known race result using the Riegel formula, with VO2max estimation also described in the project documentation.
  • heart_rate_zones calculates five training zones with the Karvonen method.
  • marathon_countdown returns the remaining time for a selected marathon event.

How it works

XWeaponX7/rundida-mcp MCP server separates remote data retrieval from local computation. Data tools fetch content through the RunDida API and cache responses for 30 minutes. These operations therefore require an internet connection, but the project states that the API does not require authentication.

Compute tools run locally and do not make API calls. The documented formulas are the Riegel formula for race prediction, the Jack Daniels method for VO2max estimation in race prediction, and the Karvonen method for heart-rate zones. Results depend on the inputs supplied by the calling assistant, such as distance, time, pace, age, resting heart rate, or a previous race result.

The server is intended for MCP clients that can launch a local Node.js process over standard input and output. The README identifies Claude, Cursor, Windsurf, and other MCP clients as supported usage contexts.

Setup and configuration

XWeaponX7/rundida-mcp MCP server requires Node.js 18 or newer. Install and launch it through the published npm package with:

Terminal
npx -y @rundida/mcp-server

For Claude Desktop, add a server entry whose command is npx and whose arguments are -y and @rundida/mcp-server. Cursor and Windsurf use the same command and argument pattern in their MCP configuration. Claude Code can register the same process with its MCP add command.

No environment variables, API keys, account, or additional service credentials are documented as required. Data features need network access to reach RunDida, while local calculation features can operate without API requests.

Tools and capabilities

The server exposes these tools:

  • list_tools: browse the available running calculators.
  • get_tool: retrieve details for a specific calculator, including FAQs and related tools.
  • list_guides: browse RunDida’s running guides.
  • get_guide: retrieve guide details, FAQs, and related tools.
  • list_marathons: list tracked marathon events with dates and locations.
  • get_marathon: retrieve details for a selected marathon.
  • calculate_pace: calculate pace, time, or distance from two supplied values.
  • predict_race: estimate a race result from a known performance.
  • heart_rate_zones: calculate five Karvonen training zones.
  • marathon_countdown: calculate a countdown to a selected event.

RunDida’s content is documented as available in English, Chinese, and Japanese in the package introduction. The broader RunDida platform also describes free calculators, guides, marathon information, and a JSON API.

Limitations and notes

The server does not provide general-purpose training-plan generation beyond the tools and RunDida content exposed through MCP. Remote content can be unavailable without an internet connection, and cached data may remain unchanged for up to 30 minutes. The project is distributed under the MIT license.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Rundida MCP

Run `npx -y @rundida/mcp-server`, then add that command to your MCP client configuration.

Yes. The README provides a Claude Desktop configuration using `npx -y @rundida/mcp-server`.

No. The project states that it is free, zero-configuration, and does not require an API key or account.

Yes. The `heart_rate_zones` tool calculates five training zones using the Karvonen method.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRundida MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/xweaponx7-rundida-mcp?style=directory)](https://allmcps.com/mcp/xweaponx7-rundida-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/xweaponx7-rundida-mcp"><img src="https://allmcps.com/api/badge/xweaponx7-rundida-mcp?style=directory" alt="Rundida MCP on AllMCPs" /></a>