Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@fitness-tools-mcp Calculate my TDEE: 32M, 180cm, 80kg, lifts 4x per week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📖 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.
You're… | Use | Why |
Writing JS/TS (browser, Node, edge) |
| Runs in-process. Install, import, call. No server, no network. |
Calling from another language / |
| Same calculators over HTTP. You run/host it. |
Building a remote frontend |
| Self-describing catalog + OpenAPI over the wire. |
Wiring the calculators into an MCP client / agent |
|
|
The API adds a network boundary, not capability. The package works the moment you install it; the server does nothing until it's running.
New to it? Getting started
What each calculator does: Tools
Calling from an agent: Consumer guide
Working on this repo: AGENTS.md
Related MCP server: Workout Planner Ai MCP
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 librarycorepack 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 :8080See each package's README — library · reference server.
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.
This server cannot be deployed
Public fitness and nutrition calculators, exercise information, and evidence-based guides.
Free calculators as MCP tools: finance, taxes, health, units, dates. Search, fetch & compute.
SmartMoney77 MCP v0.6.0 — 14 public tools that turn financial questions into exact numbers and citable links. New: historical_investment_return and compare_investments, which compute "what if I had invested" results from real yearly price data. Also compound interest, FIRE number, credit-card payoff, emergency fund, inflation, latte factor, investment fees, cost of waiting, plus discovery/deep-link/share-pack tools for a catalog of calculators in 6 languages (he/en/ar/es/pt/in). Public, no login. Endpoint: https://smartmoney77.com/mcp
Body composition for AI: BMI, body fat, FFMI, waist-to-height, plus saved measurement trends.
