fitbot-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Host interface for HTTP mode. Default: 127.0.0.1. | |
| PORT | No | Port for HTTP mode. Default: 8000. | |
| MCP_HTTP_PATH | No | Endpoint path for HTTP mode. Default: /mcp. | |
| MCP_HTTP_TOKEN | No | Bearer token for HTTP mode. If set, requires Authorization: Bearer <token>. Recommended. | |
| AIMHARDER_EMAIL | Yes | Your account email for AimHarder. | |
| OTEL_SERVICE_NAME | No | Service name for tracing. | |
| AIMHARDER_PASSWORD | Yes | Your account password for AimHarder. | |
| AIMHARDER_FINGERPRINT | No | Optional stable device fingerprint override. Generated automatically on first run and stored in ~/.fitbot-mcp/fingerprint. | |
| OTEL_RESOURCE_ATTRIBUTES | No | Extra resource attributes for tracing, e.g. service.namespace=home-utils. | |
| OTEL_EXPORTER_OTLP_ENDPOINT | No | OTLP HTTP endpoint for OpenTelemetry traces. e.g. http://tempo:4318. If not set, tracing is disabled. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_classesA | Lista las clases de un día concreto con su horario, coach, plazas ocupadas y si ya estás apuntado. |
| book_classA | Reserva una clase. Identifícala por hora de inicio (p.ej. "18:15") o por classId. Si a esa hora hay varias clases, añade 'name' para desambiguar. Con insist=true entras en lista de espera si está llena. |
| cancel_classA | Cancela tu reserva en una clase. Identifícala por hora de inicio o por classId. Usa late=true si cancelas fuera de plazo (puede penalizar según el box). |
| class_attendeesA | Lista quién se ha apuntado a una clase. NOTA: AimHarder solo expone esta lista a cuentas con rol de coach/administrador en el box; para cuentas de cliente devuelve una nota informativa. |
| list_boxesA | Muestra los boxes (gimnasios) asociados a tu cuenta y su id (boid). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool addresses a distinct operation: listing boxes, listing classes, booking, canceling, and viewing attendees. There is no overlap in purpose, and the role restriction on class_attendees does not create ambiguity.
Most tools follow a verb_noun pattern (list_boxes, list_classes, book_class, cancel_class), but class_attendees is a noun phrase rather than an imperative verb, deviating slightly from the otherwise consistent style.
Five tools is well-scoped for a fitness class booking domain. Each tool is necessary and covers the core user flow without redundancy.
Core operations (view schedule, book, cancel) are covered, but there is no direct way to list a user's own upcoming bookings across days, requiring agents to call list_classes repeatedly. This is a minor gap that can be worked around.