Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

STRUGGL Hybrid Coach

de Kubyerversión 1.3.2i★ 0iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.Kubyer/struggl

Cómo instalar

Qué hace

Zero-LLM-Math sports science calculators (Hyrox, 1RM/RPE, Zone 2, MEV/MRV) & workout ledger.

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave Funciona sin clave · añade Authorization si la tienes (suele subir los límites)
  • Categoría Clínicas y salud

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala STRUGGL Hybrid Coach. Sigue https://mcp.popnx.com/i/kubyer-struggl.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (struggl.singandclap.com) · ✓ Comandos revisados el 20 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreSTRUGGL Hybrid Coach
    Remote MCP server URL · Direcciónhttps://struggl.singandclap.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsSTRUGGL Hybrid Coach

  4. Pruébalo

    Usa STRUGGL Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando STRUGGL Hybrid Coach o muestra una herramienta de STRUGGL Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreSTRUGGL Hybrid Coach
    Connection · Direcciónhttps://struggl.singandclap.com/mcp
  3. Elige STRUGGL Hybrid Coach en un chat

    Abre un chat nuevo y elige STRUGGL Hybrid Coach en tus plugins antes de escribir

  4. Pruébalo

    Usa STRUGGL Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando STRUGGL Hybrid Coach o muestra una herramienta de STRUGGL Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user struggl https://struggl.singandclap.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver STRUGGL Hybrid Coach en la lista como conectado

  4. Pruébalo

    Usa STRUGGL Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando STRUGGL Hybrid Coach o muestra una herramienta de STRUGGL Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa STRUGGL Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando STRUGGL Hybrid Coach o muestra una herramienta de STRUGGL Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa STRUGGL Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando STRUGGL Hybrid Coach o muestra una herramienta de STRUGGL Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://struggl.singandclap.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa STRUGGL Hybrid Coach💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user struggl https://struggl.singandclap.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "struggl": {
      "url": "https://struggl.singandclap.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "struggl": {
      "type": "http",
      "url": "https://struggl.singandclap.com/mcp"
    }
  }
}

Valores que debes completar

  • Authorization secreto HTTP header
    Opcional para las 7 calculadoras científicas públicas; token Bearer stg_ath_... de https://struggl.singandclap.com/connect para sincronizar el libro personal
    Ver original en inglésOptional for all 7 public science calculators; Bearer stg_ath_... token from https://struggl.singandclap.com/connect for personal ledger sync

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
Sin licencia indicada
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
1.3.2
Publicado en el registroi
13 nov 2026
Último cambio de códigoi
19 nov 2026
Última revisión
18 nov 2026
Creador
Kubyer
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • get_profile

    Read the authenticated athlete's biometric profile (bodyweight, height, sex, primary modality, training phase, weekly time budget) and upcoming race goals. Requires Bearer token.

  • get_sessions

    List the athlete's completed and planned training sessions over the last `days` days (1–90, default 14) or on a specific `date` (YYYY-MM-DD). Call before prescribing today's workout.

  • get_muscle_volume

    Audit this week's effective hard sets across 17 muscle groups (1.0x prime mover, 0.5x synergist, RPE >= 6 gating) against evidence-based MEV / MAV / MRV weekly volume landmarks.

  • log_workout

    Record one COMPLETED exercise into the athlete's STRUGGL ledger (with duplicate-write protection, automatic PR tracking, and 17-muscle weekly volume accounting). Call once per exercise.

  • plan_workout

    Schedule one PLANNED exercise on the athlete's STRUGGL training calendar for `date` (YYYY-MM-DD). Only schedule when the athlete asks for it; call once per exercise.

  • hyrox_pace

    Public calculator (NO token needed): compute Hyrox 8x1 km compromised run splits, target pace band, estimated total race time, and Riegel 10k/Half/Marathon predictions from a 5 km time.

  • strength_benchmark

    Public calculator (NO token needed): compute piecewise Wathan e1RM, bodyweight/sex/age-adjusted strength score, tier (untrained -> elite), and kg needed for the next tier from one set.

  • interference_tax

    Public calculator (NO token needed): audit a weekly hybrid training schedule for AMPK-mTOR concurrent training interference (<3h high / 3-6h moderate window), 36h long-run glycogen depletion before legs, 48h heavy hinge recovery before speed runs, back-to-back quality runs, and S

  • volume_audit

    Public calculator (NO token needed): audit a weekly lifting split across all 17 muscle groups using fractional set accounting (1.0x primary mover, 0.5x secondary synergist, RPE >= 6 hard-set filter) against Schoenfeld & Pelland MEV / MAV / MRV landmarks.

  • hyrox_splits

    Public calculator (NO token needed): compute all 8 compromised Hyrox 1 km lap splits (with preceding station fatigue multipliers, Pro/Doubles offsets, and Lap 1 overpacing blow-up cost) from a standalone 5K time using STRUGGL's 200,000-finisher decay model.

  • plates_zone2

    Public calculator (NO token needed): convert a reference set (weight x reps @ RPE) into piecewise Wathan e1RM, Zourdos RIR/RPE working weight (accounting for bodyweight on pull_up/chin_up/dip), exact gym barbell plate pairs per side, and Tanaka + Karvonen Heart Rate Reserve Zone

  • hyrox_autopsy

    Public calculator (NO token needed): post-race or simulation Hyrox diagnostic — compares actual 8x1 km run splits and 8 functional station times against empirical compromised pacing targets and P25-P75 station variance benchmarks to pinpoint exact time leaks.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Kubyer, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ! Precaución

    Tiene licencia

    GitHub no pudo identificar el tipo de licencia; abre el archivo para comprobarlo

  • ✓ Superada

    El endpoint responde

    Respondió en 257 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 12 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/kubyer-struggl.svg)](https://mcp.popnx.com/en/servers/kubyer-struggl)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Clínicas y saludi

  • Más estrellas que el 0% de los otros 1193 servidores de esta categoría
  • Publicado en el registro más recientemente que el 83% de los otros 1193 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 55% de los otros 1193 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro STRUGGL Hybrid Coach?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (1.3.2) llegó al registro hace 7 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

de medplumMuy usado★ 2,8 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

de thetahealthEn crecimiento↓ 725/sem★ 1,6 milActualizado ayer

Se ejecuta en tu computadora✓ thetahealth.ai

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

de codescene-ossEn crecimiento↓ 3,8 mil/sem★ 85Actualizado hace 8 meses

Se ejecuta en tu computadora✓ del servicio · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

de skeletonarmytechInicial↓ 62/sem★ 5Actualizado hace 29 días

Se ejecuta en tu computadora✓ skeletonarmy.tech

WHOOP — MissingMCP

WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.

de VelkyVenikInicial★ 21 Estrellas de todo el repositorioActualizado hace 4 meses

Se ejecuta en la nube✓ missingmcp.com
Comparado con otros parecidos
Este
STRUGGL Hybrid Coach
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoSe instala en tu equipoSe instala en tu equipoFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas4/54/43/32/33/32/4
LicenciaNOASSERTIONApache-2.0Apache-2.0NOASSERTIONMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

struggl-mcp — Zero-LLM-Math Sports Science MCP & Agent Skill

Stop letting LLMs guess your 1RM, Zone 2 heart rate, weekly muscle volume, and Hyrox splits.

7 free unauthenticated sports-science calculators + optional stateful hybrid-athlete training ledger for Claude Code, Google Antigravity, Cursor, OpenAI Codex, Grok, Cline, and OpenClaw.

Connect & Docs · 5 LLM Exercise Math Traps · Agent Skill ( SKILL.md ) · Living Science Equations


Why This Exists

Ask a frontier LLM what belt weight an 80 kg athlete (+30 kg x 5 @ RPE 9 pull-up) should use for 8 reps @ RPE 8, and it routinely forgets the 80 kg bodyweight on the bar — overshooting the belt prescription by +5 kg. Ask for Zone 2 heart rate (35 yo, 48 bpm RHR) and it defaults to 220 - Age, under-prescribing by 19 bpm. Ask if 10 sets of triceps isolation on top of 26 pressing sets is recoverable, and it misses +13 fractional synergist sets above MRV.

Full reproducible breakdown with curl calls and PubMed/Crossref DOIs: [`benchmarks/llm_fitness_math_traps.md`](benchmarks/llm_fitness_math_traps.md).

struggl-mcp gives any coding or personal AI agent 13 deterministic tools over stateless Streamable HTTP (https://struggl.singandclap.com/mcp) + an interactive MCP Apps UI Card (ui://struggl/coach-card.html) + a portable `agentskills.io` `SKILL.md`.


7 Free Science Tools (Zero Auth, Zero Install, Instant Value)

Connect https://struggl.singandclap.com/mcp with no token and no signup to unlock all 7 deterministic calculators immediately:

ToolWhat It ComputesLiterature / Model Basis
hyrox_paceCompromised Hyrox pace band, 8x1 km run total, race time & Riegel 10K/HM/Marathon200k-finisher curve + Riegel (1981)
hyrox_splitsExact Lap 1–8 1 km splits (0.94x–1.03x), Pro/Doubles offsets & Lap 1 overpacing blow-up cost200k-finisher piecewise decay (DOI: 10.3389/fphys.2025.1519240)
hyrox_autopsyPost-race or mock-sim diagnostic: per-lap fade vs. target + P25–P75 station bottleneck leaksEmpirical station variance benchmarks
strength_benchmarkPiecewise Wathan e1RM, sex/BW/age score (0–100), tier (untrained -> elite) & kg to next tierWathan (1994) / LeSuer et al. (1997)
plates_zone2reps @ RPE working weight (with BW system load on pull_up/chin_up/dip), gym plate pairs & Zone 2 bpmZourdos (2016) RIR + Tanaka (2001) & Karvonen (1957) HRR
volume_auditWeekly 17-muscle hypertrophy audit (1.0x prime / 0.5x synergist, RPE >= 6 hard-set gate) & junk volumeSchoenfeld (2017), Pelland (2024), Robinson (2024)
interference_taxWeekly hybrid schedule conflict check (<3h/3–6h AMPK-mTOR, 36h glycogen, 48h hinge, 80/20 drift)Wilson (2012), Robineau (2016), Schumann (2022), Seiler (2010)

6 Personal Training Ledger Tools (Optional Account Sync)

For athletes who want their coding agent to fetch a 1-call physiological coaching brief (get_coaching_brief), check real 14-day fatigue between coding blocks, audit live weekly sets, and batch-log or schedule workouts (get_profile, get_sessions, get_muscle_volume, log_workout, plan_workout — automatically mirrored into a read-only feed in the STRUGGL mobile/web app):

  1. Start your 30-day free STRUGGL Coach trial (no credit card) at [https://struggl.singandclap.com/connect](https://struggl.singandclap.com/connect).
  2. Connect via OAuth 2.1 + PKCE (https://struggl.singandclap.com/v1/connector/mcp) or generate a scoped read / read + write personal token (stg_ath_...).

10-Second Install Across Every Agent Platform

1. Claude Code & Claude Desktop / Web

1-Click OAuth 2.1 Sign-In (Recommended — Zero Manual API Keys):

claude mcp add --transport http struggl https://struggl.singandclap.com/v1/connector/mcp

*(In Claude Code run /mcp → struggl → Authenticate; in Claude.ai / ChatGPT Connectors paste https://struggl.singandclap.com/v1/connector/mcp to open browser sign-in + interactive ui://struggl/coach-card.html UI cards.)*

Instant Zero-Auth (7 free science calculators + Agent Skill):

claude mcp add --transport http struggl https://struggl.singandclap.com/mcp

Or install the full plugin + skills via Claude Code's plugin manager:

/plugin marketplace add Kubyer/struggl-mcp

/plugin install struggl@struggl-marketplace

Headless Personal Token Fallback:

claude mcp add --transport http struggl https://struggl.singandclap.com/mcp \

--header "Authorization: Bearer stg_ath_YOUR_PERSONAL_TOKEN"

2. Universal SKILL.md (skills.sh — Cursor, Antigravity, Claude Code, Codex, Copilot)
npx skills add Kubyer/struggl-mcp
3. Google Antigravity

Install directly via plugin.json (OAuth 2.1 automatic sign-in on https://struggl.singandclap.com/v1/connector/mcp), or add to ~/.gemini/antigravity/mcp_config.json:

{

"mcpServers": { "struggl": { "serverUrl": "https://struggl.singandclap.com/mcp" } } }

4. Cursor & Windsurf (.cursor/mcp.json)
{

"mcpServers": { "struggl": { "url": "https://struggl.singandclap.com/mcp" } } }

5. OpenAI Codex & ChatGPT (~/.codex/config.toml / Custom MCP)
[mcp_servers.struggl]

url = "https://struggl.singandclap.com/mcp"

*(In ChatGPT Connectors, connect `https://struggl.singandclap.com/v1/connector/mcp` via OAuth 2.1.)*
6. Gemini CLI (geminicli.com/extensions)
gemini extensions install https://github.com/Kubyer/struggl-mcp
7. Lovable (lovable.dev)

In your Lovable workspace (Settings → Connectors → Custom MCP Server), add https://struggl.singandclap.com/mcp for zero-auth sports-science tools while building fitness apps, or https://struggl.singandclap.com/v1/connector/mcp with OAuth 2.1.

8. OpenClaw / ClawHub & Nous Hermes
clawhub install struggl-coach
9. One-Line CLI / Local stdio Bridge (npx, uvx, Python)

For local stdio-only MCP hosts without native Streamable HTTP support:

# Node.js >= 18 (zero-dependency npx stdio bridge -> https://struggl.singandclap.com/mcp)

npx -y struggl-mcp

Python >= 3.10 (also installs import struggl_primitives)

uvx struggl-mcp

or: pip install struggl-mcp && struggl-mcp

Set STRUGGL_API_TOKEN=stg_ath_YOUR_PERSONAL_TOKEN in the MCP server's env if you also want the 6 personal ledger tools alongside the 7 zero-auth science calculators.


Open-Core Primitives for Fitness & Coaching AI Builders

Building your own strength, running, Hyrox, or wearable coaching agent? Never let raw LLM prose improvise exercise math:

  • [`struggl_primitives.py`](struggl_primitives.py): Pure-stdlib Python reference functions (wathan_e1rm, prescribe_working_load, karvonen_zone2, ewma_acwr, hyrox_compromised_pace, fractional_set_credit) plus ready-to-register PRIMITIVE_TOOL_SCHEMAS.
  • [`skills/fitness-agent-primitives/SKILL.md`](skills/fitness-agent-primitives/SKILL.md): Builder skill teaching coding agents where stateless single-session math ends and longitudinal 30-day state (implicit RIR envelopes, 0.82^d / 0.96^d EWMA ACWR, 17-muscle weekly MEV/MAV/MRV, 48h concurrent interference gating) begins.

Repository Architecture & Open-Source Standards

This repository follows the multi-registry agent package layout so a single repo works cleanly across MCP registries and Agent Skill directories:

struggl-mcp/

├── server.json # Official MCP Registry schema (2025-12-11) ├── plugin.json / mcp_config.json # Google Antigravity, Cursor & Grok Bot manifest ├── .claude-plugin/ # Claude Code plugin & marketplace manifests ├── .mcp.json # Root Streamable HTTP MCP config (zero auth ready) ├── agents/openai.yaml # OpenAI Codex / Dots skill-to-MCP wiring ├── llms-install.md # Cline Marketplace 1-click installer ├── struggl_primitives.py # Pure-stdlib stateless exercise-physiology primitives ├── skills/ │ ├── struggl-coach/ # Athlete coaching skill + inline UI card template │ └── fitness-agent-primitives/ # Builder skill for custom fitness & Hyrox AI agents ├── benchmarks/llm_fitness_math_traps.md ├── bin/cli.mjs # Zero-dependency npx stdio-to-HTTP bridge ├── package.json / pyproject.toml # npm (npx struggl-mcp) & PyPI (uvx struggl-mcp) manifests └── mcp_server.py # Zero-secret thin HTTP->stdio client (httpx + mcp only)

Security & Privacy

  • Zero Secrets in Repo: This repository contains declarative manifests, open-source skill instructions, pure-stdlib physiology primitives, literature benchmarks, and a thin HTTP client (mcp_server.py imports only Python stdlib, httpx, and mcp). Run python scripts/verify_public_bundle.py to audit every file.
  • OAuth 2.1 + Scoped Revocable Tokens: Supports 1-click OAuth 2.1 + PKCE (https://struggl.singandclap.com/v1/connector/mcp) and optional scoped tokens (stg_ath_...), stored server-side strictly as SHA-256 hashes and revocable at https://struggl.singandclap.com/connect.
  • Privacy Policy, Terms & Support: Privacy Policy · Terms of Service · API & Connector Docs · taha@tbaziz.com.

License

Apache License 2.0 — see LICENSE and NOTICE. Covers the manifests, SKILL.md workflows, struggl_primitives.py reference primitives, benchmark documentation, and thin mcp_server.py client in this repository. The hosted STRUGGL coaching engine and longitudinal datasets at struggl.singandclap.com are operated by Sing And Clap.