Running Formulas

MCP server offering VDOT, training paces, race-time predictions, velocity markers, HR zones, and pace conversions using Daniels, McMillan, and Riegel methods.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "st3v-running-formulas-mcp": {
      "command": "uvx",
      "args": [
        "running-formulas-mcp"
      ]
    }
  }
}

You run the running-formulas-mcp server to access practical running calculators and race-time predictors through an MCP-compatible client. It combines Jack Daniels, McMillan, and Riegel methodologies with tools for pacing, velocity markers, heart-rate zones, and pace conversions, letting you plan training and predict results with confidence.

How to use

Connect to the MCP server using your MCP client. Use the client to call the available tools by name and pass the required inputs. You can compute VDOT from a race performance, obtain recommended training paces for a given VDOT, predict race times, derive velocity markers and heart-rate zones, and convert between pace formats. Use the results to tailor training plans, race strategies, and pacing conversions for your workouts and events.

How to install

Prerequisites you need before starting the MCP server are a runtime environment and a way to launch MCP-compatible servers.

# No local install is required for the MCP server configuration snippet
# The server is expected to run via an MCP runner that supports stdio configuration.

Configuration and startup

The MCP server is configured as a stdio endpoint that runs under the MCP runner. Use the following runtime configuration to connect the MCP client to the server.

{
  "mcpServers": {
    "running_formulas_mcp": {
      "command": "uvx",
      "args": ["running-formulas-mcp"]
    }
  }
}

Additional sections (notes)

Tools available include Daniels and McMillan calculations, Riegel-based predictions, and pace conversions. All inputs and outputs use clear units and formats to keep your planning precise.

Available tools

daniels_calculate_vdot

Calculate VDOT from race performance using Jack Daniels' formula.

daniels_calculate_training_paces

Get recommended training paces for a given VDOT, including easy, marathon, threshold, interval, and repetition paces.

daniels_predict_race_time

Predict race time using Jack Daniels' equivalent performance methodology.

mcmillan_calculate_velocity_markers

Calculate velocity markers (vLT, CV, vVO2) from race performance.

mcmillan_predict_race_times

Predict race times for standard distances using McMillan methodology.

mcmillan_calculate_training_paces

Calculate comprehensive training paces across endurance, stamina, speed, and sprint zones.

mcmillan_heart_rate_zones

Calculate training heart rate zones using multiple estimation formulas.

riegel_predict_race_time

Predict race time using Riegel's power law.

convert_pace

Convert between pace and speed units (min/km, min/mile, km/h, mph).