Calcula la repetición máxima (1RM) en cualquier ejercicio de fuerza usando las fórmulas Epley y Brzycki. Devuelve el 1RM estimado y una tabla de cargas de entrenamiento por porcentaje.
| Name | Required | Description | Default |
|---|---|---|---|
| peso_kg | Yes | Peso levantado en kilogramos | |
| repeticiones | Yes | Número de repeticiones completadas con ese peso (idealmente 1-12 para mayor precisión) |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
La anotación readOnlyHint=true es consistente con la descripción que indica un cálculo. La descripción añade que utiliza las fórmulas Epley y Brzycki y devuelve una tabla de cargas, proporcionando contexto útil que no está en las anotaciones ni en el esquema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Dos oraciones concisas y frontales. Cada oración aporta información esencial: propósito, fórmulas usadas y salida. Sin redundancias ni palabras de relleno.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Dado que no hay esquema de salida, la descripción describe correctamente la salida (1RM estimado y tabla de cargas). Para una calculadora simple con dos parámetros, la información es suficiente. Podría mencionar el rango de repeticiones válido, pero ya está en el esquema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
La cobertura del esquema es del 100%, por lo que la línea base es 3. La descripción no agrega significado adicional a los parámetros más allá de lo que ya está en las descripciones del esquema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
El verbo 'calcula' y el recurso 'repetición máxima (1RM)' son claros y específicos. Se distingue fácilmente de los hermanos, que son otras calculadoras temáticas no relacionadas con la fuerza.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
La descripción indica que es para cualquier ejercicio de fuerza, pero no proporciona pautas sobre cuándo usarla frente a alternativas, ni menciona limitaciones de uso (ej. rango de repeticiones). No hay hermanos directos, pero podría mejorar con instrucciones explícitas.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
