Fitness Tools

io.github.almostjackedPublished by GitHub account almostjackedv0.3.4Updated Oct 25, 2026

Deterministic fitness calculators — TDEE, adaptive TDEE, body fat, 1RM, macros — with consensus.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

A fitness calculator server that lets an assistant compute TDEE, body fat, one-rep max, macros, lifting attempts and muscle-potential estimates from published,

What you can do
Estimate energy needs: BMR/TDEE by several formulas, adaptive TDEE from logged weight and calorie history, and activity multipliers from a lookup table or a NEAT+EAT model. Estimate body composition: body-fat percentage by Navy, skinfold and BMI methods, FFMI with a natural-ceiling flag, and RSMI with sarcopenia cutoffs. Estimate strength: one-rep max from a submaximal set with a percentage load chart, and powerlifting opener/second/third attempts with warmup ramp and plate loading. Plan nutrition: protein, fat and carb grams for a calorie target. Estimate drug-free maximum bodyweight at a target body-fat percentage.
When to use it
Useful when an assistant should do repeatable fitness math rather than improvise numbers: training plans, calorie and macro targets, strength progression, or body-composition and muscle-potential estimates. Each calculator runs several published formulas and reports a consensus, so it suits users who want the method and spread shown.
Requirements
Runs as a hosted remote endpoint or as a local stdio process via npx from the npm package. No authentication, environment variables or headers are declared. The local route needs Node.js and network access to fetch the package.
Before you install
The calculators are estimates from population formulas, not medical advice or measurement. The muscle-potential tool is men-only in this version. Adaptive TDEE depends on the weight and calorie history the user supplies, so results are only as good as that log. No credentials or write actions are involved.

Installation

In SourceWeft

  1. Open Fitness Tools in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.almostjacked%2Ffitness-tools/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "fitness-tools": {
      "type": "http",
      "url": "https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp"
    }
  }
}

README

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?

You're…UseWhy
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-apiSelf-describing catalog + OpenAPI over the wire.
Wiring the calculators into an MCP client / agent@almostjacked/fitness-tools-mcpnpx 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

Layout

packages/core   @almostjacked/fitness-tools — the library (the product)apps/api        @almostjacked/fitness-tools-api  — a reference HTTP server over the libraryapps/mcp        @almostjacked/fitness-tools-mcp  — an MCP stdio server over the library

Develop

bash
corepack enable              # pnpm version is pinned in package.jsonpnpm installpnpm -r test                 # core + api + mcp test suitespnpm -C packages/core build  # build the librarypnpm -C apps/api dev         # run the reference server on :8080

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.

Source: README.md at commit ee0b492

Tools

10

tdee

Total Daily Energy Expenditure

Estimate BMR and TDEE via Mifflin-St Jeor, Harris-Benedict, Katch-McArdle, and Cunningham. Provide body_fat or lean_mass to unlock the LBM-based methods.

Parametersagerequiredsexrequiredheightrequiredweightrequiredmethodsactivityrequiredbody_fatlean_mass

adaptive-tdee

Adaptive TDEE

Measure actual TDEE from a logged history of daily weight and/or calorie intake. Default method (kalman) is a joint Kalman filter over true weight and TDEE — handles missing days, gates outliers, and reports uncertainty (CI95) alongside denoised true weight; regression/endpoints are simple window-based estimates kept for comparison. Use instead of formula TDEE once real logged data exists. Each entry needs at least one of weight/kcal (not necessarily both). Entry dates must span 10 years or less (earliest to latest). Note: all methods need at least one weigh-in (kalman) or two (regression/endpoints) — a history with zero weight entries throws under the kalman default; pass methods:'all' to get a graceful empty/skipped result instead.

Parametersentriesrequiredmethodswindow_daysprior_tdee_kcal

body-fat

Body Fat Percentage

Estimate body-fat % via US Navy circumference, Jackson-Pollock 3-site skinfold, and Deurenberg (BMI-based) methods.

Parametersagehipsexrequiredneckwaistheightweightmethodsskinfold_sum

one-rep-max

One-Rep Max

Estimate 1RM from a submaximal set via Epley, Brzycki, Lombardi, Wathan, O'Conner, and Mayhew; returns a %1RM load chart.

Parametersrepsrequiredweightrequiredmethods

macros

Macronutrient Split

Compute protein/fat/carb grams for a calorie target using the g-per-kg-bodyweight method, with goal-based protein defaults.

Parametersgoalweightrequiredmethodscaloriesrequiredfat_g_per_kgprotein_g_per_kg

activity-multiplier

Activity Multiplier

Estimate the TDEE activity multiplier via the classic lookup table or a NEAT+EAT model (occupation/steps for non-exercise, training volume for exercise).

Parametersbmrweightmethodsintensityoccupationsteps_per_dayactivity_levelsession_minutessessions_per_week

powerlifting-attempts

Powerlifting Meet Attempts

Deterministic opener/second/third attempts from an estimated 1RM, plus a warmup ramp and per-side plate loading. Tunable by aggressiveness and available plates.

Parametersbar_weightone_rep_maxrequiredaggressivenessavailable_plates

muscle-potential

Maximum Muscular Potential

Estimate drug-free maximum bodyweight at a target body-fat % via Casey Butt (wrist+ankle), the FFMI~25 natural cap, and Berkhan's max-contest-weight model. Men only in v1.

Parameterssexrequiredanklewristheightrequiredmethodstarget_body_fat_pct

ffmi

Fat-Free Mass Index

Compute the Fat-Free Mass Index (FFMI) and its height-adjusted form from weight and body fat (or lean mass), and flag whether it exceeds the ~25 natural ceiling.

Parametersheightrequiredweightrequiredmethodsbody_fatlean_mass

rsmi

Relative Skeletal Muscle Index

Estimate the appendicular skeletal muscle index (RSMI) from a DXA value (direct) and/or an anthropometric estimate (Wen 2011), and flag low muscle mass against EWGSOP2, AWGS, and Baumgartner sarcopenia cutoffs.

Parametersagerequiredsexrequiredasm_kgheightrequiredweightrequiredmethods

Version history

1
  1. v0.3.4LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts