Fitfly Engine

io.github.dropflyaiPublished by GitHub account dropflyaiv0.2.0Updated Oct 25, 2026

Deterministic fitness coaching engine: adaptive programs, progression math, readiness autoregulation

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

A remote fitness coaching engine that lets an assistant fetch adaptive workouts, log lifts, check readiness, and manage programs and nutrition targets.

What you can do
Fetch today's session with exercises, sets/reps, target weights, nutrition targets and cycle status, adjusted by readiness check-in; record energy, sleep and soreness to score readiness and reshape the workout; log completed lifts in kg to get progression, PR detection and next-time targets; list valid same-muscle alternatives and swap an exercise for today or the whole program; read or regenerate the multi-day program; get daily calorie and macro targets and a USDA-checked meal plan; read a changelog explaining coaching decisions.
When to use it
Useful when an athlete or coach wants an assistant to run day-to-day training: see what to do now, record what was lifted, adjust for fatigue, swap exercises, or explain why the plan changed.
Requirements
Remote streamable HTTP endpoint; a bearer token in the Authorization header is required. FitFly users mint a personal access token through the engine's token endpoint, and coaches mint athlete tokens via the partner API.
Before you install
The Authorization bearer token is a personal credential and should be kept private. Logging workouts, readiness check-ins, swaps and program regeneration write to the athlete's stored plan and history. Program regeneration and meal planning are slow AI calls, and meal plans may be approximate when macros cannot be met.

Installation

In SourceWeft

  1. Open Fitfly Engine in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. 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.dropflyai%2Ffitfly-engine/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": {
    "fitfly-engine": {
      "type": "http",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Tools

10

get_todays_session

Get today's training session

Today's workout: exercises, sets/reps, per-exercise load guidance and concrete target weights, plus nutrition targets and cycle status. Auto-applies the user's readiness check-in (autoregulation) if they've done one today. Call this to see what the athlete should do now.

ParametersdayIndex

readiness_checkin

Log a readiness check-in

Record how the athlete feels today (energy, sleep, soreness — each 1–5). The engine scores readiness and, on the next get_todays_session, reshapes the workout accordingly (reduce volume / reduce intensity / recovery day). Returns the readiness score + modifier.

Parameterssleeprequiredenergyrequiredsorenessrequired

log_workout

Log completed sets

Record what the athlete actually lifted. The engine runs progression (double-progression, e1RM), detects PRs, and returns per-exercise outcomes (established/progressed/held/deloaded) with next-time targets. Weights are in kg.

ParametersgoaldayIndexexercisesrequired

list_swap_options

List same-area swap options for an exercise

Valid alternatives for an exercise — same muscle group, filtered to the athlete's equipment/level/injuries. Use before swap_exercise.

ParametersexerciseIdrequired

swap_exercise

Swap an exercise

Replace an exercise with a valid same-area alternative. scope 'today' = just this session; scope 'program' = going forward. The new lift starts fresh (day-one calibration).

ParametersscopedayIndexexerciseIdrequiredtoExerciseIdrequired

get_program

Get the active program

The athlete's current multi-day program (render-ready).

Takes no parameters.

regenerate_program

Regenerate the program

Rebuild the whole program from the stored profile (~20s AI generation). Use after a profile change or a plateau.

Takes no parameters.

nutrition_targets

Get nutrition targets

The athlete's daily calorie + macro targets, computed from body stats, activity, and goal.

Takes no parameters.

meal_plan

Generate a meal plan

A day of meals hitting the athlete's targets, USDA truth-checked (flags feasible=false with a note when macros are approximate). Slow (~15s AI call).

ParametersexclusionsmealsPerDaytrainingDaydietaryStyle

changelog

What the engine changed and why

The 'what changed & why' feed — the engine's coaching decisions (volume bumps, deloads, swaps) in Coach Fly's voice. Use to explain to the athlete why their plan evolved.

Parameterslimit

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

83% 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

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.