automeli-docs-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUTOMELI_DOCS_BASE | No | Base de los artefactos. Usar www (el apex hace 301). | https://www.automeli.com |
| AUTOMELI_DOCS_TIMEOUT_MS | No | Timeout del fetch live antes de caer al cache/snapshot. | 5000 |
| AUTOMELI_DOCS_TTL_SECONDS | No | Frescura del cache en memoria. | 900 |
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_endpointsA | Índice de todos los endpoints de la API pública de Automeli (v2 por default): método, path, summary, scope, entorno de key (test/live/any), idempotencia y costo en créditos. Punto de partida para descubrir la API. El campo api_version confirma qué versión de la doc se leyó. |
| get_endpointA | Devuelve el detalle completo de un endpoint: parámetros, request body (schema + ejemplo), respuestas con ejemplos, scope, costo en créditos, idempotencia, códigos de error y la prosa de la doc. Identificá el endpoint por operationId (ej. 'v2-products-create'; ver list_endpoints) o por method+path (ej. method='POST', path='/products'). |
| search_docsA | Búsqueda léxica en toda la documentación: endpoints, errores, guías y flujos. Devuelve resultados rankeados con tipo, título, referencia (operationId / código de error / URL) y un extracto. Útil para '¿cómo publico un producto?', 'rate limit', 'cursor', 'idempotencia', etc. |
| explain_errorA | Dado un código de error (campo 'code' del body RFC 7807, ej. 'E_RATE_LIMITED'), devuelve el status HTTP, cuándo ocurre, la URL de doc y qué endpoints pueden emitirlo. El catálogo es contrato público estable y COMPARTIDO entre v1 y v2: hacé switch sobre 'code'. |
| generate_snippetA | Devuelve un snippet de código listo para usar (curl, JavaScript fetch o Python requests) para un endpoint, idéntico al de la web. Identificá el endpoint por operationId o por method+path. Los valores de API Key son placeholders. |
| describe_flowA | Devuelve la guía narrativa de un flujo end-to-end de la API. Hoy disponible: 'test-to-live' (publicar en prueba → promover → real), el flujo recomendado. |
| get_openapiA | Devuelve el documento OpenAPI 3.1 completo de la API (v2 por default; el mismo de www.automeli.com/api-docs/openapi.json). Útil para generar clientes o cargar el contrato entero. |
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 7 tools
Cada herramienta tiene un propósito claramente distinto: listar endpoints, obtener detalle, buscar en docs, explicar errores, generar snippets, describir flujos y obtener OpenAPI. No hay solapamiento ambiguo; las descripciones refuerzan cuándo usar cada una.
Todos los nombres siguen el patrón verbo_objeto en snake_case (list_endpoints, get_endpoint, search_docs, explain_error, generate_snippet, describe_flow, get_openapi). Es altamente consistente y predecible.
Siete herramientas es un número bien ajustado para un servidor de documentación de API; cada una cubre una necesidad de descubrimiento o consulta sin redundancia.
La superficie cubre descubrimiento, detalle, búsqueda, errores, snippets, flujos y contrato OpenAPI, lo cual es muy completo para docs. Faltaría, por ejemplo, una herramienta para listar versiones de API o comparar cambios, pero son carencias menores.