@exerciseapi/mcp-server

@exerciseapi/mcp-server

Servidor MCP oficial para exerciseapi.dev — dale a tu agente de codificación con IA acceso directo a más de 2,198 ejercicios verificados en 12 categorías.

¿Estás construyendo una aplicación de fitness, entrenamiento, rehabilitación o bienestar con Claude Code, Cursor, Windsurf o Cline? Deja de pedirle a tu agente que invente datos de ejercicios. Instala este servidor MCP y tu agente obtendrá seis herramientas que extraen ejercicios reales y estructurados directamente de la biblioteca de exerciseapi.dev.

Por qué existe esto

Los LLM alucinan instrucciones de ejercicios. Inventan grupos musculares. Mezclan señales de forma. Te dirán alegremente que hagas un "reverse-grip incline cable fly" con consejos de seguridad que podrían lastimar a alguien.

Este servidor le da a tu agente acceso a:

• Más de 2,198 ejercicios en fuerza, calistenia, yoga, pilates, movilidad, fisioterapia, pliometría, estiramientos y más.
• Datos musculares anatómicos reales — primarios y secundarios, músculos específicos no solo "pecho" o "piernas".
• Consejos de forma y notas de seguridad escritos por humanos, no generados.
• Filtros de equipo, dificultad y categoría para que el agente pueda crear entrenamientos precisos.
• Videos de demostración para un subconjunto creciente de ejercicios (y contando).

Es un envoltorio delgado alrededor de la API REST de exerciseapi.dev. Todo el filtrado y la búsqueda se ejecutan en el servidor — la capa MCP solo lo hace invocable como herramientas.

Instalación

1. Obtén una clave de API gratuita

Regístrate en exerciseapi.dev/dashboard. El plan gratuito te da 100 solicitudes/día, que es suficiente para desarrollo. No se requiere tarjeta de crédito.

2. Añádelo a tu cliente MCP

Claude Desktop / Claude Code — añádelo a ~/.config/claude/claude_desktop_config.json (o al .mcp.json de tu proyecto):

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Cursor — añádelo a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Windsurf, Cline, Zed — misma forma, pégalo en la configuración MCP de tu cliente.

3. Reinicia tu agente

Reinicia Claude Desktop / Cursor / Windsurf para que detecte el nuevo servidor. Listo.

Pruébalo

Después de la instalación, pregúntale a tu agente algo como:

Encuéntrame cinco ejercicios de pecho que pueda hacer solo con mancuernas, nivel intermedio. Para cada uno, muéstrame los consejos de forma.

Tu agente llamará a search_exercises con los filtros correctos, obtendrá datos reales y responderá con ejercicios precisos provenientes de la biblioteca. Sin alucinaciones.

O:

Estoy construyendo una aplicación de entrenamiento de cuerpo completo para principiantes. Extrae 8 ejercicios de empuje, tirón y piernas que no necesiten equipo.

O:

¿Cuál es la diferencia entre press de banca con barra y press de banca con mancuernas en términos de activación muscular?

Herramientas

Este servidor expone seis herramientas:

Herramienta	Qué hace
search_exercises	Busca en la biblioteca por nombre, categoría, músculo, equipo o dificultad. Devuelve hasta 100 ejercicios.
get_exercise	Obtén detalles completos de un solo ejercicio por ID — instrucciones, consejos de forma, notas de seguridad, variaciones, video.
list_categories	Lista las 12 categorías de ejercicios con conteos.
list_muscles	Lista los músculos anatómicos disponibles como filtros.
list_equipment	Lista los tipos de equipo disponibles como filtros.
get_stats	Estadísticas generales de la biblioteca: conteo total, desglose por categoría, cobertura de video.

La referencia completa de herramientas está en la página de documentación de MCP.

¿Por qué exerciseapi.dev?

	exerciseapi.dev	ExerciseDB	free-exercise-db	API Ninjas
Número de ejercicios	2,198 (objetivo 10,000+)	~1,300	~800	~3,000
Categorías	12 (fuerza, yoga, fisioterapia, movilidad, pilates, etc.)	Solo fuerza	Solo fuerza	7 tipos
Palabras clave de búsqueda	✅ 5–10 por ejercicio	❌	❌	❌
Consejos de forma	✅ 3–4 por ejercicio	❌	❌	❌
Notas de seguridad	✅ Detalladas	❌	❌	Básicas
Músculos anatómicos específicos	✅	✅	❌	❌
Variaciones	✅ 3–5 por ejercicio	❌	❌	❌
Videos de demostración	✅ En crecimiento	✅ GIFs	❌	❌
Servidor MCP	✅ Este paquete	❌	❌	❌
Plan gratuito	100 solicitudes/día	Ninguno	N/A (estático)	100 solicitudes/mes
El plan de pago comienza en	$5/mes	$10/mes	—	$10/mes

Construido específicamente para desarrolladores que usan agentes de codificación con IA. El esquema, las descripciones de herramientas, el formato de documentación — todo diseñado para que un LLM pueda tomarlo y usarlo correctamente a la primera.

Configuración

Variables de entorno requeridas

Var	Descripción
EXERCISEAPI_KEY	Tu clave de API de exerciseapi.dev/dashboard. Requerida. El servidor se cerrará al inicio si falta.

Variables de entorno opcionales

Var	Predeterminado	Descripción
EXERCISEAPI_BASE_URL	https://api.exerciseapi.dev	Sobrescribe la URL base de la API. Útil para autoalojamiento o pruebas contra staging.

Solución de problemas

"Variable de entorno EXERCISEAPI_KEY no configurada" Olvidaste añadir la clave a la configuración de tu cliente MCP, o no reiniciaste el cliente después de añadirla. Verifica el JSON en tu archivo de configuración y reinicia.

"Clave de API inválida" La clave fue rechazada. Genera una nueva en exerciseapi.dev/dashboard y actualiza tu configuración.

"Cuota diaria alcanzada" Has alcanzado el límite de 100 solicitudes/día del plan gratuito. Espera hasta mañana (se restablece a medianoche UTC) o mejora en exerciseapi.dev/pricing.

El agente no está usando las herramientas Dos causas comunes: (1) el servidor no se inició — revisa los registros del servidor MCP de tu cliente, generalmente en la consola de desarrollador o en un archivo de registro. (2) El agente no cree que las herramientas sean relevantes. Intenta preguntar más explícitamente: "Usa las herramientas de exerciseapi para encontrarme…"

El arranque en frío es lento en la primera ejecución npx -y @exerciseapi/mcp-server descarga el paquete la primera vez que lo usas. Para omitir la descarga en cada reinicio, instala globalmente: npm install -g @exerciseapi/mcp-server, luego cambia command a exerciseapi-mcp en tu configuración.

Acceso directo a la API (sin MCP)

Si prefieres usar la API REST directamente en lugar de MCP — por ejemplo, si estás construyendo una integración del lado del servidor o no estás en un cliente MCP compatible — consulta exerciseapi.dev/docs. La misma clave de API funciona para ambos.

También hay un prompt universal de copiar y pegar en la página de inicio que puedes insertar en cualquier herramienta de codificación con IA para obtener una integración funcional de una sola vez, sin necesidad de MCP.

Contribuciones

Se aceptan issues y PRs. Este servidor es intencionalmente un envoltorio delgado — si hay lógica que quieras cambiar, probablemente pertenezca a la API REST (repositorio privado). Abre un issue primero si no estás seguro.

Licencia

MIT © Vegh Labs LLC

---

Construido por West Vegh. Si esto te ahorra un fin de semana de construir infraestructura de datos de ejercicios, saluda en el panel o envíame una nota a west@veghlabs.com.