protogrid

Search / io.github.dropflyai/fitfly-engine

fitfly-engine

R1· needs a key

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

v0.2.0 · active · website · descriptor JSON · versions

An agent can connect on its own if it already holds FITFLY_ENGINE_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality79good
Trust73of 100
Uptime, 30 days100%
Latency p50262 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "fitfly-engine": {
      "type": "http",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer ${FITFLY_ENGINE_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http fitfly-engine https://workout-engine-production-5dd7.up.railway.app/mcp --header "Authorization: Bearer ${FITFLY_ENGINE_TOKEN}"
[mcp_servers.fitfly-engine]
url = "https://workout-engine-production-5dd7.up.railway.app/mcp"
bearer_token_env_var = "FITFLY_ENGINE_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fitfly-engine": {
      "type": "remote",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:FITFLY_ENGINE_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "fitfly-engine": {
      "type": "http",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer ${FITFLY_ENGINE_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=fitfly-engine&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd29ya291dC1lbmdpbmUtcHJvZHVjdGlvbi01ZGQ3LnVwLnJhaWx3YXkuYXBwL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0ZJVEZMWV9FTkdJTkVfVE9LRU59In19"
}
{
  "servers": {
    "fitfly-engine": {
      "type": "http",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer ${FITFLY_ENGINE_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "fitfly-engine": {
      "httpUrl": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer ${FITFLY_ENGINE_TOKEN}"
      }
    }
  }
}
extensions:
  "fitfly-engine":
    enabled: true
    name: "fitfly-engine"
    type: streamable_http
    uri: "https://workout-engine-production-5dd7.up.railway.app/mcp"
    headers:
      "Authorization": "Bearer ${FITFLY_ENGINE_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${FITFLY_ENGINE_TOKEN}. The registry never accepts secret values.

Quality 79 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: readiness_checkin (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); log_workout (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); list_swap_options (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 1,125 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

10 tools, about 1,125 tokens to load them all · tool set 80c6e12dbbbc · checked 2026-10-20 10:35 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 73 / 100

no-repository
provenance45
liveness100
freshness65
hygiene80

+website +reachable +uptime-100% ~updated-110d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://workout-engine-production-5dd7.up.railway.app/mcp streamable-httpapi_key ${FITFLY_ENGINE_TOKEN}yes100%262 ms2025-11-252026-10-20

Tools (10)

changelogThe '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.
get_programThe athlete's current multi-day program (render-ready).
get_todays_sessionToday'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.
list_swap_optionsValid alternatives for an exercise — same muscle group, filtered to the athlete's equipment/level/injuries. Use before swap_exercise.
log_workoutRecord 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.
meal_planA 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).
nutrition_targetsThe athlete's daily calorie + macro targets, computed from body stats, activity, and goal.
readiness_checkinRecord 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.
regenerate_programRebuild the whole program from the stored profile (~20s AI generation). Use after a profile change or a plateau.
swap_exerciseReplace 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).

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.dropflyai/fitfly-engine",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer fft_... personal access token. FitFly users mint one via POST /api/engine/me/mcp-token; coaches mint athlete tokens via the partner API. See /connect."
        }
      ]
    }
  ],
  "version": "0.2.0",
  "websiteUrl": "https://workout-engine-production-5dd7.up.railway.app/connect",
  "description": "Deterministic fitness coaching engine: adaptive programs, progression math, readiness autoregulation"
}