Skip to main content
Glama

@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.

Website npm License: MIT

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"]
  }
}

Related MCP server: TrackLab MCP Ultimate Edition

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)

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

Available Tools

10 tools
calculate_paceA

Calculate running pace, finish time, or distance. Provide any two of: distance, time, pace.

Inputs: distance, time, pace.

get_guideA

Get detailed information about a specific running guide including FAQs and related tools

Inputs: slug (required).

get_marathonA

Get detailed information about a specific marathon including countdown and Schema.org data

Inputs: id (required).

get_toolB

Get detailed information about a specific running tool including FAQs and related tools

Inputs: slug (required).

heart_rate_zonesA

Calculate heart rate training zones using the Karvonen method

Inputs: age (required), resting_hr, max_hr.

list_guidesA

List all running guides and educational articles on RunDida

Inputs: no named parameters.

list_marathonsA

List all marathon events tracked by RunDida with dates and locations

Inputs: no named parameters.

list_toolsA

List all available running calculators and tools on RunDida

Inputs: no named parameters.

marathon_countdownB

Get a countdown to a specific marathon event

Inputs: id (required).

predict_raceB

Predict race finish times using the Riegel formula based on a known race result

Inputs: known_distance (required), known_time (required), target_distance.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: calculations (pace, HR zones, prediction) and information retrieval (guides, marathons, tools) are separated, with no overlap.

    Naming Consistency5/5

    All tools use snake_case with a consistent verb_noun pattern (e.g., calculate_pace, heart_rate_zones, list_marathons), making the set predictable.

    Tool Count5/5

    With 10 tools, the server covers a reasonable scope for a running resource: calculators, info queries, and listings. Not too sparse or overloaded.

    Completeness4/5

    The tool set covers major running needs (pace, HR zones, race prediction, event info). A minor gap is the lack of a calorie calculator, but the domain is well served.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive running performance calculations including VDOT, training paces, race time predictions, velocity markers, and heart rate zones using Jack Daniels, Greg McMillan, and Riegel methodologies.
      9
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to create and manage multi-week running training plans, track workouts and activities, and pull calendar or CSV exports through the app's API. Supports plan generation with configurable goals, mileage, schedule, and intensity, plus updating workout status and recording completed runs.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to run finance, military, school, and everyday calculations through 69 hosted calculator tools over a no-auth Streamable HTTP endpoint, returning results with deep links to the matching interactive calculators.
      MIT