Agent Ready

Escáner de legibilidad para agentes de IA: 59 verificaciones contra la especificación de Vercel, llmstxt.org y los manifiestos de agent-protocol, con guía de corrección por verificación.

GitHub

Prueba este MCPPatrocinado

Documentación

agent-ready-mcp

Servidor MCP para Agent Ready — analiza cualquier URL para verificar la legibilidad para agentes de IA según el Vercel Agent Readability Spec, el estándar llmstxt.org y los manifiestos de protocolos de agentes (tarjetas de servidor MCP, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). 72 verificaciones en cuatro familias de especificaciones — 40 verificaciones de sitio y página (15 en todo el sitio + 25 por página), 10 contra llmstxt.org y 22 contra manifiestos de protocolos de agentes — cada una con orientación de corrección por verificación, más una subpuntuación de accesibilidad separada de 23 verificaciones de WCAG 2.2 / estabilidad de diseño.

Alojado en https://agent-ready.dev/api/v1/mcp (HTTP Streamable); este paquete es un envoltorio delgado de stdio alrededor de los mismos endpoints REST, distribuido a través de npm para clientes MCP locales (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf).

Características

scan_site — análisis fresco de legibilidad para agentes en cualquier URL. Funciona sin clave en el nivel gratuito anónimo (3 análisis/30 días por IP, profundidad de 25 páginas, síncrono); con una clave Pro analiza hasta 250 páginas, consultando la API alojada hasta 60 s.
get_scan — recupera un análisis previamente ejecutado por id (se requiere clave Pro — el historial de análisis está vinculado a la cuenta).
ask — búsqueda en lenguaje natural (NLWeb) sobre la metodología, verificaciones y especificaciones propias de Agent Ready. Pública, no requiere clave API; devuelve resultados tipados con Schema.org.
validate_structured_data — valida el JSON-LD de una página (o pegado) contra las verificaciones de datos estructurados de Agent Ready. Pública, no requiere clave API; el modo de pegado no necesita red, por lo que un agente puede verificar JSON-LD que acaba de crear.
Tres indicaciones de descubrimiento — scan, interpret_scan, remediation_plan. Flujos de trabajo de extremo a extremo desde URL → puntuación → plan de corrección.
SKILL.md — descriptor de Skill de Claude incluido en skills/agent-ready/ para el enrutamiento de activación.

Configuración

No se requiere clave para comenzar: scan_site, ask y validate_structured_data funcionan de forma anónima de inmediato (scan_site en la cuota gratuita anónima — 3 análisis por 30 días por IP a una profundidad de 25 páginas). Una clave API Pro de Agent Ready desbloquea 50 análisis/mes, profundidad de 250 páginas, historial de análisis (get_scan) y monitoreo semanal — regístrate en agent-ready.dev y emite una clave desde el panel. El bloque env en las configuraciones a continuación es opcional; omítelo para ejecutar sin clave.

Claude Desktop

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agent-ready": {
      "command": "npx",
      "args": ["-y", "agent-ready-mcp@latest"],
      "env": {
        "AGENT_READY_API_KEY": "ar_live_..."
      }
    }
  }
}

Claude Code

claude mcp add agent-ready \
  -e AGENT_READY_API_KEY=ar_live_... \
  -- npx -y agent-ready-mcp@latest

Cursor / VS Code / Windsurf

.cursor/mcp.json, .vscode/mcp.json o ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agent-ready": {
      "command": "npx",
      "args": ["-y", "agent-ready-mcp@latest"],
      "env": {
        "AGENT_READY_API_KEY": "ar_live_..."
      }
    }
  }
}

Variables de entorno

Variable	Requerida	Predeterminado	Propósito
`AGENT_READY_API_KEY`	No	—	Token Bearer Pro del panel de Agent Ready. Sin él, `scan_site` usa el nivel gratuito anónimo y `get_scan` no está disponible.
`AGENT_READY_API_URL`	No	`https://agent-ready.dev`	Anulación para implementaciones autoalojadas o de staging.
`AGENT_READY_SCAN_TIMEOUT_MS`	No	`60000`	Cuánto tiempo consulta `scan_site` antes de devolver un marcador de posición `running`.
`AGENT_READY_GET_TIMEOUT_MS`	No	`5000`	Tiempo de espera para `get_scan` y las recuperaciones por consulta.

Herramientas

Herramienta	Entradas	Devuelve
`scan_site`	`url` (cadena, requerida), `pageLimit` (número, opcional, máx. 2000 — limitado por tu plan; fijado en 25 sin clave)	Objeto de análisis: puntuación Vercel 0–100, subpuntuación llms.txt 0–100, hallazgos por verificación con cadenas `howToFix`. Las ejecuciones sin clave usan el nivel gratuito anónimo (3 análisis/30 días por IP) y devuelven de forma síncrona; con una clave Pro, devuelve el marcador de posición `{ id, status: "running" }` si el análisis supera el plazo de consulta.
`get_scan`	`id` (cadena, id de análisis de una llamada previa a `scan_site`)	El mismo objeto de análisis que `scan_site`, o `not_found` si el id es desconocido o no pertenece al usuario autenticado. Se requiere clave Pro.
`ask`	`q` (cadena, requerida), `itemType` (filtro de corpus opcional), `mode` (opcional, `list` o `summarize`)	`/ask` NLWeb sobre la metodología, verificaciones y especificaciones de Agent Ready. Pública — no requiere clave API. Objetos de resultado tipados con Schema.org.
`validate_structured_data`	exactamente uno de `url` (cadena) o `jsonld` (cadena)	Resultado de datos estructurados de la serie D: `mode`, `url`, hallazgos por verificación y un veredicto `summary`. Pública — no requiere clave API. Valida el lint de esquema y la coherencia de agentes que los validadores de terceros no cubren.

Indicaciones

Indicación	Argumentos	Qué hace
`scan`	`url`	Análisis fresco + resumen de alto nivel (puntuación, calificación, principales 3–5 fallos, siguiente paso).
`interpret_scan`	`id`	Explicación en lenguaje sencillo de los hallazgos de un análisis anterior, agrupados por categoría.
`remediation_plan`	`id`, `focus` opcional (`"seo"` o `"agents"`)	Documento de corrección priorizado con grupos Ahora/Siguiente/Después e ids de verificación por corrección.

Flujo de trabajo de ejemplo

You: Use agent-ready to scan https://my-saas.com
Claude: [calls scan_site] Your site scored 78/100 (Good) on the Vercel Agent
        Readability Spec. The top 3 fixes: …
You: Can you build me a remediation plan?
Claude: [calls remediation_plan with the scan id] Here's the prioritised list…

Skill (Anthropic Claude Skills)

Un SKILL.md se encuentra en skills/agent-ready/SKILL.md dentro del paquete. Para usarlo en Claude Desktop / Claude Code, copia el directorio skills/agent-ready/ en ~/.claude/skills/.

El skill describe cuándo activarse (URL + intención de auditoría de legibilidad), qué herramienta elegir, cómo mostrar los resultados del análisis sin volcar JSON sin procesar y cuándo diferir a otras herramientas (SEO general, perfilado de rendimiento, edición de código).

Cómo funciona

Este paquete es un envoltorio delgado de stdio→HTTPS:

MCP client (stdio) ↔ agent-ready-mcp ↔ HTTPS ↔ agent-ready.dev/api/v1/scans

Toda la ejecución de análisis, persistencia y aplicación de cuotas del nivel Pro ocurren en el servidor alojado. El paquete npm solo traduce entre MCP JSON-RPC sobre stdio y la API REST.

Si prefieres usar el servidor MCP alojado directamente (transporte HTTP Streamable, sin instalación local), apunta tu cliente MCP a https://agent-ready.dev/api/v1/mcp con Authorization: Bearer ar_live_....

Metodología

Las 72 verificaciones, sus pesos y la fórmula de puntuación están documentados en agent-ready.dev/methodology. Tanto manifest.json como server.json en este repositorio cumplen con los esquemas de registro relevantes (Glama Marketplace v0.3 y registro MCP 2025-12-11 respectivamente).

Desarrollo

npm install
npm run build       # → dist/mcp-server.mjs
npm test
npm run typecheck

Publicación

Consulta RELEASE.md. Es la fuente de verdad para las superficies de versión, verificaciones locales, push de etiquetas, el flujo de trabajo de publicación de GitHub Actions y los pasos manuales posteriores a la publicación.

Licencia

MIT — consulta LICENSE.