Cuando un agente llama a la herramienta equivocada, la causa suelen ser las descripciones. Pega la URL de tu servidor MCP y recibe una revisión de cada descripción y esquema, con reescrituras sugeridas.
Una descripción ajustada para la selección de herramientas no es documentación que un cliente pueda leer. MCP Showcase genera ambas cosas desde el mismo servidor: esquemas ligeros para el agente y un playground en vivo con documentación real para los demás.
Leemos las definiciones de herramientas que anuncia tu servidor: exactamente lo que recibe un agente al conectarse.
Descripciones ausentes o demasiado escuetas, parámetros sin documentar, esquemas sin propiedades declaradas y textos largos que cuestan contexto real en cada turno.
Una puntuación, cada problema con la herramienta afectada y, donde cambiaría de verdad el comportamiento del modelo, una descripción alternativa sugerida.
La descripción de una herramienta MCP no es documentación para personas. Se envía al modelo en
cada petición y es lo único que el modelo usa para decidir si llama a esa herramienta.
Cuando un agente elige delete_branch en lugar de list_branches, casi
nunca es un fallo del agente: son dos descripciones que el modelo no pudo distinguir.
Pega arriba la URL de tu servidor MCP y este linter leerá cada definición de herramienta que anuncia tu servidor, exactamente como la recibe un agente, e informará de lo que hace que la selección sea poco fiable.
required: entonces todos los parámetros parecen
opcionales, el modelo omite uno necesario y recibe un error.Conviene decirlo claramente porque el instinto suele fallar aquí: el linter señala las descripciones demasiado largas igual que las demasiado cortas. Las definiciones de herramientas se reenvían en cada petición, así que un párrafo de más se paga en cada turno de cada conversación, para siempre, sin mejorar la precisión de la elección. Busca una o dos frases concretas: qué hace la herramienta y cuándo elegirla frente a la de al lado. Puedes ver exactamente cuánto cuesta tu lista actual con la calculadora de tokens MCP.
Una puntuación de calidad, cada hallazgo con la herramienta afectada y, donde una reescritura cambiaría de verdad el comportamiento del modelo, una descripción alternativa sugerida. Las comprobaciones en sí no usan ningún modelo y se ejecutan siempre. Las reescrituras sugeridas sí, y tienen un presupuesto mensual para que la herramienta siga siendo gratuita; si se agota, el informe lo dice con claridad y todos los hallazgos anteriores siguen en pie.
Ajustar una descripción para la selección de herramientas la vuelve breve, concreta y orientada a la máquina, e inútil para un cliente que intenta entender qué hace tu servidor. Esa tensión es real y no se resuelve escribiendo mejor. MCP Showcase la zanja generando ambas cosas desde el mismo servidor: tus esquemas ligeros siguen yendo al modelo, mientras que los clientes potenciales obtienen un playground en vivo con documentación legible por herramienta que pueden probar de verdad en el navegador.