MCP Server: io.github.almostjacked/fitness-tools

The io.github.almostjacked/fitness-tools MCP server provides deterministic fitness calculators, including TDEE, adaptive TDEE, body fat, 1RM, and macros, with consensus. The server focuses on calculation consistency rather than open-ended recommendations, and is intended for use as a structured tool within an MCP environment.

🛠️ Key Features

Deterministic fitness calculators
Includes: TDEE, adaptive TDEE, body fat, 1RM, macros
Consensus-based calculations

🚀 Use Cases

Calculating daily energy needs (TDEE)
Estimating adaptive TDEE values
Computing body fat metrics
Estimating 1RM
Generating macro targets

⚡ Developer Benefits

Predictable outputs via deterministic calculators
Standard set of fitness calculation tools (TDEE, adaptive TDEE, body fat, 1RM, macros)

⚠️ Limitations

Limited to the provided calculator scope: TDEE, adaptive TDEE, body fat, 1RM, macros (no other tools described)

Fitness Tools

📖 Documentation · npm

Use it with your AI right now: add the hosted MCP connector https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp in claude.ai / ChatGPT settings, install one-click in Cursor or VS Code, or grab the Claude Desktop .mcpb.

Composable, deterministic fitness calculators — BMR/TDEE, body fat, 1RM, macros, activity multiplier, powerlifting attempts, and natural muscular potential. Each calculator runs several published formulas and reports a consensus across them.

This repo ships three separate, independently-usable artifacts:

@almostjacked/fitness-tools — the npm library. Validated, self-describing calculators that run natively in the browser and on the server. This is the product.
@almostjacked/fitness-tools-api — a reference HTTP server built on the library. It re-exposes the same calculators over HTTP (identical math, identical results) and is inert until you run or host it.
@almostjacked/fitness-tools-mcp — an MCP stdio server built on the library. It exposes the same calculators as MCP tools for agents/LLM clients (identical math), runnable with npx @almostjacked/fitness-tools-mcp.

Which one do you want?

You're…	Use	Why
Writing JS/TS (browser, Node, edge)	`@almostjacked/fitness-tools` (npm)	Runs in-process. Install, import, call. No server, no network.
Calling from another language / `curl` / a no-code tool	`@almostjacked/fitness-tools-api` (HTTP)	Same calculators over HTTP. You run/host it.
Building a remote frontend	`@almostjacked/fitness-tools-api`	Self-describing catalog + OpenAPI over the wire.
Wiring the calculators into an MCP client / agent	`@almostjacked/fitness-tools-mcp`	`npx` an MCP stdio server; one tool per calculator.

The API adds a network boundary, not capability. The package works the moment you install it; the server does nothing until it's running.

Documentation

New to it? Getting started
What each calculator does: Tools
Calling from an agent: Consumer guide
Working on this repo: AGENTS.md

Layout

code

packages/core   @almostjacked/fitness-tools — the library (the product)
apps/api        @almostjacked/fitness-tools-api  — a reference HTTP server over the library
apps/mcp        @almostjacked/fitness-tools-mcp  — an MCP stdio server over the library

Develop

bash

corepack enable              # pnpm version is pinned in package.json
pnpm install
pnpm -r test                 # core + api + mcp test suites
pnpm -C packages/core build  # build the library
pnpm -C apps/api dev         # run the reference server on :8080

See each package's README — library · reference server.

License

MIT — free, open-source, and usable in commercial products. See LICENSE. Built on published formulas (Mifflin-St Jeor, US Navy, Jackson-Pollock, Epley, Casey Butt, etc.); contributions welcome.

sex	string	required
age	number	required
height	object	required
weight	object	required
activity	any	required
body_fat	any	optional
lean_mass	any	optional
methods	any	optional

entries	array	required
window_days	integer	optional
prior_tdee_kcal	number	optional	Optional starting TDEE estimate, e.g. from the tdee tool; speeds early convergence.
methods	any	optional

sex	string	required
age	any	optional
height	any	optional
weight	any	optional
neck	any	optional
waist	any	optional
hip	any	optional
skinfold_sum	any	optional
methods	any	optional

weight	object	required
reps	integer	required
methods	any	optional

calories	number	required
weight	object	required
goal	string	optional
protein_g_per_kg	any	optional
fat_g_per_kg	any	optional
methods	any	optional

Fitness Tools

MCP Server: io.github.almostjacked/fitness-tools

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

tdee

adaptive-tdee

body-fat

one-rep-max

macros

activity-multiplier

powerlifting-attempts

muscle-potential

ffmi

rsmi

Fitness Tools

Which one do you want?

Documentation

Layout

Develop

License

Install

activity_level	any	optional
bmr	any	optional
weight	any	optional
sessions_per_week	any	optional
session_minutes	any	optional
intensity	any	optional
steps_per_day	any	optional
occupation	any	optional
methods	any	optional

one_rep_max	object	required
bar_weight	any	optional
available_plates	any	optional
aggressiveness	string	optional