Fitness Tools
[CI]
[License: MIT]
[npm]
[MCP Registry]
📖 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?
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
Layout
Develop
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.