{
  "name": "tempocito",
  "title": "Running pace API (tempocito.com)",
  "description": "Free API and MCP server for runners: pace, speed and splits for any distance and time, race time predictions (Riegel and Daniels VDOT), training paces from vVO2max, and heart rate zones (Tanaka, Karvonen). Every answer in km and miles. No key, CORS open, messages in English.",
  "version": "1.0.0",
  "serverUrl": "https://tempocito.com/api/mcp",
  "transport": "streamable-http",
  "protocolVersion": "2025-11-25",
  "supportedProtocolVersions": [
    "2025-11-25",
    "2025-06-18",
    "2025-03-26"
  ],
  "authentication": {
    "type": "none"
  },
  "capabilities": {
    "tools": {}
  },
  "documentation": "https://tempocito.com/pace-api",
  "openapi": "https://tempocito.com/api/openapi.json",
  "tools": [
    {
      "name": "calculate_pace",
      "title": "Pace, speed and splits",
      "description": "Compute the running pace (per km and per mile), speed (km/h and mph) and split times for a distance and a finish time. Pace = time ÷ distance. Use it for 'what pace do I need for a 3:30 marathon' or 'how fast is 25:00 for 5K'.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "distance": {
            "type": "string",
            "description": "Race distance: a race name (5k, 10k, half, marathon) or a number with its unit (10km, 6.2mi, 400m). A bare number is read as km.",
            "example": "marathon"
          },
          "time": {
            "type": "string",
            "description": "Finish time: h:mm:ss or mm:ss (also 1h30, 90min, or seconds).",
            "example": "3:30:00"
          }
        },
        "required": [
          "distance",
          "time"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "predict_race_times",
      "title": "Race time predictions",
      "description": "Predict 5K, 10K, half marathon and marathon times from one recent race result, with two models: Riegel (T2 = T1 × (D2/D1)^1.06) and Jack Daniels' VDOT. Predictions assume the training for the target distance is done; a marathon prediction from a 5K is optimistic without long runs.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "distance": {
            "type": "string",
            "description": "Distance of the race you ran: a race name (5k, 10k, half, marathon) or a number with its unit (10km, 6.2mi, 400m). A bare number is read as km.",
            "example": "10k"
          },
          "time": {
            "type": "string",
            "description": "Your time on it: h:mm:ss or mm:ss (also 1h30, 90min, or seconds).",
            "example": "45:00"
          }
        },
        "required": [
          "distance",
          "time"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "training_paces",
      "title": "Training paces from vVO2max",
      "description": "Training paces (per km and per mile) for each intensity zone, as a percentage of vVO2max (maximal aerobic speed). Give vVO2max in km/h, or a recent race (distance and time) to estimate it with the Péronnet-Thibault endurance model.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "vvo2max_kmh": {
            "type": "number",
            "description": "vVO2max in km/h, from a field test (half Cooper: meters in 6 minutes ÷ 100).",
            "example": 16
          },
          "distance": {
            "type": "string",
            "description": "Or: distance of a recent race: a race name (5k, 10k, half, marathon) or a number with its unit (10km, 6.2mi, 400m). A bare number is read as km.",
            "example": "10k"
          },
          "time": {
            "type": "string",
            "description": "Or: your time on it: h:mm:ss or mm:ss (also 1h30, 90min, or seconds).",
            "example": "45:00"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "heart_rate_zones",
      "title": "Max heart rate and zones",
      "description": "Estimate max heart rate from age (Tanaka 208 − 0.7 × age, Gellish, Fox 220 − age) and give the five training zones in bpm: as % of max HR, or with the Karvonen method when the resting heart rate is given. A measured max HR overrides the estimate.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "age": {
            "type": "number",
            "description": "Age in years (10 to 90).",
            "example": 35
          },
          "resting_hr": {
            "type": "number",
            "description": "Resting heart rate in bpm (30 to 110), for Karvonen zones.",
            "example": 55
          },
          "max_hr": {
            "type": "number",
            "description": "Measured max heart rate in bpm (120 to 230), if known.",
            "example": 186
          }
        },
        "required": [
          "age"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "training_plan",
      "title": "Training plan",
      "description": "Week by week training plan for a 5K, 10K, half marathon or marathon goal time, the same plan as the site's plan page: phases (base, development, intensity, taper, race), each session with its pace. Paces come from the goal race pace, or from VO2max when given; age over 40 adds recovery, a previous time on the distance spreads the progression.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "distance": {
            "type": "string",
            "description": "Goal race: 5k, 10k, half or marathon.",
            "enum": [
              "5k",
              "10k",
              "half",
              "marathon"
            ],
            "example": "half"
          },
          "goal_time": {
            "type": "string",
            "description": "Goal finish time: h:mm:ss or mm:ss (also 1h30, 90min, or seconds).",
            "example": "1:45:00"
          },
          "sessions_per_week": {
            "type": "number",
            "description": "Runs per week: 3 or 4 for 5K and 10K, 3 to 6 for half and marathon. Default 3.",
            "example": 4
          },
          "weeks": {
            "type": "number",
            "description": "Plan length in weeks: 6-12 (5K), 4-12 (10K), 8-20 (half), 12-24 (marathon). Default 8, 8, 12, 16.",
            "example": 12
          },
          "age": {
            "type": "number",
            "description": "Age in years (10 to 90): from 40, more recovery between hard sessions.",
            "example": 42
          },
          "vo2max": {
            "type": "number",
            "description": "Measured VO2max in ml/kg/min (20 to 90), to set the paces from it.",
            "example": 50
          },
          "previous_time": {
            "type": "string",
            "description": "Your latest time on the same distance: h:mm:ss or mm:ss (also 1h30, 90min, or seconds).",
            "example": "1:52:00"
          },
          "unit": {
            "type": "string",
            "description": "Unit of the paces written in the sessions: km or mi. Default km.",
            "enum": [
              "km",
              "mi"
            ],
            "example": "km"
          }
        },
        "required": [
          "distance",
          "goal_time"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ]
}