@almostjacked/fitness-tools-mcp

@almostjacked/fitness-tools-mcp

An MCP stdio server that exposes the @almostjacked/fitness-tools calculators as MCP tools — one tool per calculator (TDEE, body fat, 1RM, macros, activity multiplier, powerlifting attempts, muscle potential). Same math as the library and the HTTP API; the only difference is the protocol.

Works with any MCP-compatible client (Claude Code, Claude Desktop, Cursor, Windsurf, Zed, Cline, Continue, and others).

Use it

Hosted (no install)

Add a custom connector in claude.ai / Claude Desktop → Settings → Connectors:

https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp

Claude Desktop one-click

Download fitness-tools.mcpb and double-click it.

npx (no install)

npx @almostjacked/fitness-tools-mcp

Claude Code

claude mcp add fitness-tools -- npx -y @almostjacked/fitness-tools-mcp

Claude Desktop / generic client config

{
  "mcpServers": {
    "fitness-tools": {
      "command": "npx",
      "args": ["-y", "@almostjacked/fitness-tools-mcp"]
    }
  }
}

Tools

Per-tool inputs, methods, and citations live on the tool pages — identical across library, HTTP, and MCP.

Each tool returns both structuredContent (validated against the calculator's output schema) and a JSON text fallback. Invalid input and domain errors come back as tool errors (isError: true), not crashes.

For agent-facing usage — picking a tool, reading consensus/skipped, error handling, and a chained workflow — see the consumer guide.

Privacy Policy

The calculators are stateless: inputs are used only to compute the result of the call that contains them — no accounts, no storage, no logging of inputs, no third-party sharing. The local/desktop versions run entirely on your machine and make no network calls. Full policy: https://almostjacked.github.io/fitness-tools/privacy/

Develop

pnpm -C apps/mcp test       # vitest (in-memory client/server)
pnpm -C apps/mcp build      # emit dist/
pnpm -C apps/mcp dev        # tsx watch (stdio)