Developers and AI agents
FitCalcs Calculator API
FitCalcs publishes its fitness calculators as a read-only public API and as an MCP server for AI clients. Three GET endpoints return deterministic results that each name the equation behind them: TDEE and calories use the Mifflin-St Jeor equation, BMI uses NHS categories with waist-to-height ratio, and race prediction uses the Riegel model. There is no authentication and no personal data is collected. Released under CC BY 4.0. Informational only, not medical or dietary advice.
REST endpoints
Base URL https://fitcalcs.co.uk/api. All responses are JSON with open CORS, an ETag and edge caching. Full machine-readable contract: OpenAPI 3.1 spec.
| Method | Path | Description |
|---|---|---|
| GET | /api/tdee | TDEE, BMR and calorie targets from the Mifflin-St Jeor equation. https://fitcalcs.co.uk/api/tdee?sex=male&age=30&height=178&weight=80&activity=1.55 |
| GET | /api/bmi | BMI with NHS categories, healthy-weight range, and optional waist-to-height ratio. https://fitcalcs.co.uk/api/bmi?height=178&weight=80&waist=86 |
| GET | /api/race-predict | Predict 5K, 10K, half and marathon times from one recent result (Riegel). https://fitcalcs.co.uk/api/race-predict?distance=10k&timeSeconds=3000 |
MCP server
The same maths is exposed as a remote Model Context Protocol server over streamable HTTP, so MCP-capable AI clients can call the calculators directly.
- Endpoint:
https://fitcalcs.co.uk/mcp(JSON-RPC 2.0, POST) - Manifest: /.well-known/mcp.json
- Tools:
calculate_tdee,calculate_bmi,predict_race_times
Equations
- TDEE and calories: Mifflin-St Jeor BMR multiplied by an activity factor of 1.2 to 1.9; weight-change targets at roughly 7,700 kcal per kg.
- BMI: weight kg divided by height m squared, with NHS categories; waist-to-height ratio flags 0.5 and above as increased risk.
- Race prediction: Riegel, T2 = T1 multiplied by (D2 divided by D1) to the power 1.06.
Terms
Read-only and free under CC BY 4.0: attribute FitCalcs and link back to the relevant calculator or the UK fitness statistics page. These tools provide general information, not medical, dietary or training advice. Please cache responses and avoid abusive request rates.
Calculators and Data Desk, FitCalcs
FitCalcs' editorial desk builds and documents the calculators, citing the underlying equation and the UK dataset behind every number. Health-related tools are editorially reviewed, with figures cited to named UK sources.
Last reviewed: 12 June 2026