{
  "markdown": "# Fitness Tools\n\n[![CI](https://github.com/almostjacked/fitness-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/almostjacked/fitness-tools/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![npm](https://img.shields.io/npm/v/%40almostjacked%2Ffitness-tools)](https://www.npmjs.com/package/@almostjacked/fitness-tools)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.almostjacked%2Ffitness--tools-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=almostjacked)\n\n📖 **[Documentation](https://almostjacked.github.io/fitness-tools/)** · [npm](https://www.npmjs.com/package/@almostjacked/fitness-tools)\n\n**Use it with your AI right now:** add the hosted MCP connector\n`https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp` in claude.ai / ChatGPT settings,\n[install one-click in Cursor](https://cursor.com/install-mcp?name=fitness-tools&config=eyJ0eXBlIjogImh0dHAiLCAidXJsIjogImh0dHBzOi8vZml0bmVzcy10b29scy1tY3AuYWp3YWxsYWNlbXVzaWMud29ya2Vycy5kZXYvbWNwIn0%3D)\nor [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),\nor grab the [Claude Desktop `.mcpb`](https://github.com/almostjacked/fitness-tools/releases).\n\nComposable, deterministic fitness calculators — BMR/TDEE, body fat, 1RM, macros, activity\nmultiplier, powerlifting attempts, and natural muscular potential. Each calculator runs\nseveral published formulas and reports a consensus across them.\n\nThis repo ships **three separate, independently-usable artifacts**:\n\n- **[`@almostjacked/fitness-tools`](packages/core)** — the npm **library**. Validated,\n  self-describing calculators that run natively in the browser and on the server. **This is\n  the product.**\n- **[`@almostjacked/fitness-tools-api`](apps/api)** — a **reference HTTP server** built on the library.\n  It re-exposes the same calculators over HTTP (identical math, identical results) and is\n  inert until you run or host it.\n- **[`@almostjacked/fitness-tools-mcp`](apps/mcp)** — an **MCP stdio server** built on the library.\n  It exposes the same calculators as MCP tools for agents/LLM clients (identical math), runnable\n  with `npx @almostjacked/fitness-tools-mcp`.\n\n## Which one do you want?\n\n| You're… | Use | Why |\n|---|---|---|\n| Writing JS/TS (browser, Node, edge) | **`@almostjacked/fitness-tools`** (npm) | Runs in-process. Install, import, call. No server, no network. |\n| Calling from another language / `curl` / a no-code tool | **`@almostjacked/fitness-tools-api`** (HTTP) | Same calculators over HTTP. You run/host it. |\n| Building a remote frontend | **`@almostjacked/fitness-tools-api`** | Self-describing catalog + OpenAPI over the wire. |\n| Wiring the calculators into an MCP client / agent | **`@almostjacked/fitness-tools-mcp`** | `npx` an MCP stdio server; one tool per calculator. |\n\n> The API adds a network boundary, not capability. The package works the moment you install\n> it; the server does nothing until it's running.\n\n### Documentation\n\n- **New to it?** [Getting started](https://almostjacked.github.io/fitness-tools/start-here/getting-started/)\n- **What each calculator does:** [Tools](https://almostjacked.github.io/fitness-tools/tools/tdee/)\n- **Calling from an agent:** [Consumer guide](https://almostjacked.github.io/fitness-tools/mcp/agents/)\n- **Working on this repo:** [AGENTS.md](AGENTS.md)\n\n## Layout\n\n```\npackages/core   @almostjacked/fitness-tools — the library (the product)\napps/api        @almostjacked/fitness-tools-api  — a reference HTTP server over the library\napps/mcp        @almostjacked/fitness-tools-mcp  — an MCP stdio server over the library\n```\n\n## Develop\n\n```bash\ncorepack enable              # pnpm version is pinned in package.json\npnpm install\npnpm -r test                 # core + api + mcp test suites\npnpm -C packages/core build  # build the library\npnpm -C apps/api dev         # run the reference server on :8080\n```\n\nSee each package's README — [library](packages/core/README.md) ·\n[reference server](apps/api/README.md).\n\n## License\n\n**MIT** — free, open-source, and usable in commercial products. See [LICENSE](LICENSE).\nBuilt on published formulas (Mifflin-St Jeor, US Navy, Jackson-Pollock, Epley, Casey Butt,\netc.); contributions welcome.\n",
  "bytes": 4391,
  "sha": "1ac76154756106b9c9e6e35ee07923b30903a67b04bca5ca04b27e9ecf9cf187",
  "repo_slug": "almostjacked/fitness-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_almostjacked_fitness_tools_fd6676cb/readme"
}