Fitness Tools
Deterministic fitness calculators — TDEE, adaptive TDEE, body fat, 1RM, macros — with consensus.
Open source Repository Open in the app JSON README (API)
About
Deterministic fitness calculators — TDEE, adaptive TDEE, body fat, 1RM, macros — with consensus.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- almostjacked
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.3.4
- Stars
- 1
- Last push
- 2026-07-24T16:57:13Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:24
- Updated
- 2026-08-29 03:02:24
- Origin id
io.github.almostjacked/fitness-tools
README
# Fitness Tools [](https://github.com/almostjacked/fitness-tools/actions/workflows/ci.yml) [](LICENSE) [](https://www.npmjs.com/package/@almostjacked/fitness-tools) [](https://registry.modelcontextprotocol.io/v0/servers?search=almostjacked) 📖 **[Documentation](https://almostjacked.github.io/fitness-tools/)** · [npm](https://www.npmjs.com/package/@almostjacked/fitness-tools) **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](https://cursor.com/install-mcp?name=fitness-tools&config=eyJ0eXBlIjogImh0dHAiLCAidXJsIjogImh0dHBzOi8vZml0bmVzcy10b29scy1tY3AuYWp3YWxsYWNlbXVzaWMud29ya2Vycy5kZXYvbWNwIn0%3D) or [VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=fitness-tools&config=%7B%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A//fitness-tools-mcp.ajwallacemusic.workers.dev/mcp%22%7D), or grab the [Claude Desktop `.mcpb`](https://github.com/almostjacked/fitness-tools/releases). 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`](packages/core)** — 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`](apps/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`](apps/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](https://almostjacked.github.io/fitness-tools/start-here/getting-started/) - **What each calculator does:** [Tools](https://almostjacked.github.io/fitness-tools/tools/tdee/) - **Calling from an agent:** [Consumer guide](https://almostjacked.github.io/fitness-tools/mcp/agents/) - **Working on this repo:** [AGENTS.md](AGENTS.md) ## Layout ``` 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](packages/core/README.md) · [reference server](apps/api/README.md). ## License **MIT** — free, open-source, and usable in commercial products. See [LICENSE](LICENSE). Built on published formulas (Mifflin-St Jeor, US Navy, Jackson-Pollock, Epley, Casey Butt, etc.); contributions welcome.