AgentReady MCP

Haz que cualquier sitio web sea consultable por agentes de IA — indexa un sitio y haz preguntas con respuestas citadas mediante RAG

GitHub

Prueba este MCPPatrocinado

Documentación

@agentreadyweb/mcp

¿Qué es AgentReady?

AgentReady es una capa de capacidades alojada que hace que cualquier sitio web sea descubrible y utilizable por agentes a través de MCP.

Pega una URL → AgentReady rastrea el sitio, genera un llms.txt conforme a especificaciones y aloja un endpoint RAG /ask en vivo y un servidor MCP. Cualquier cliente de agente compatible con MCP puede entonces descubrir el sitio, hacer preguntas en lenguaje natural, inspeccionar capacidades y crear planes de solo lectura fundamentados con citas.

El problema que resuelve: Los agentes de IA que usan web_fetch obtienen una página a la vez, reciben HTML vacío de SPAs de JavaScript (React, Next.js, Vue) y alucinan cuando la respuesta abarca varias páginas. AgentReady indexa todo el sitio, maneja el renderizado de JS y recupera información entre páginas — para que los agentes obtengan la respuesta correcta en lugar de una incorrecta pero confiada.

Lo que ya está indexado: Explora el directorio de AgentReady en vivo → o indexa cualquier sitio público tú mismo.

Propiedades clave:

Funciona con cualquier URL pública — sitios estáticos, SPAs de React/Next.js, Docusaurus, GitBook, motores personalizados
No se requiere cuenta para indexar tu primer sitio
Índice compartido — un miembro del equipo envía un sitio, todos en el equipo pueden consultarlo al instante
Maneja páginas renderizadas con JS para las que web_fetch devuelve vacío
Los manifiestos de capacidades exponen frescura, esquemas, endpoints y límites de solo lectura
Los planes fundamentados devuelven evidencia, riesgos, requisitos de confirmación y recibos duraderos

CLI

El mismo paquete funciona como CLI — sin instalación, sin cuenta:

# Agent-readiness report card (llms.txt, sitemap, robots, JS-rendering, index status)
npx @agentreadyweb/mcp grade yourdocs.com

# Ask any site a question, get a cited answer (auto-indexes new sites in ~60s)
npx @agentreadyweb/mcp ask stripe.com "what is the test card number?"

# Index or re-crawl a site
npx @agentreadyweb/mcp index yourdocs.com
npx @agentreadyweb/mcp refresh yourdocs.com

Para CI, paneles o scripts, agrega --json para recibir el informe crudo en stdout (el progreso permanece en stderr):

npx @agentreadyweb/mcp grade yourdocs.com --json | jq '.grade, .score'

El comando aún sale con 1 cuando la calificación está por debajo de B.

grade sale con código distinto de cero por debajo de B, para que puedas usarlo como compuerta de CI. refresh en tu pipeline de despliegue de documentación mantiene el índice fresco automáticamente:

# GitHub Actions — after your docs deploy step
- run: npx @agentreadyweb/mcp refresh yourdocs.com

Conecta cualquier cliente compatible con MCP a AgentReady:

Puente MCP local (stdio)

Para clientes que usan una configuración mcpServers, agrega el puente de AgentReady:

{
  "mcpServers": {
    "agentready": {
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

Reinicia tu cliente. Tendrás ocho herramientas disponibles:

list_sites — ver todos los sitios web indexados
get_site_capabilities — indexar bajo demanda, luego inspeccionar el manifiesto del sitio, frescura, esquemas y endpoints
get_site_facts — hechos estructurados clave extraídos de un sitio
ask_site — consultar cualquier sitio con respuestas citadas de varias páginas
plan_site_action — indexar bajo demanda, luego crear un plan de solo lectura fundamentado y un recibo
submit_site — indexar cualquier sitio web para que pueda ser consultado
refresh_site — volver a rastrear un sitio, o realizar su indexación inicial cuando es nuevo
rate_answer — enviar comentarios de calidad

Cursor

Agrega a ~/.cursor/mcp.json:

{
  "agentready": {
    "command": "npx",
    "args": ["-y", "@agentreadyweb/mcp"]
  }
}

Configuración de proyecto o terminal

npx @agentreadyweb/mcp

O agrega el mismo servidor agentready a la configuración del proyecto de tu cliente para compartirlo con tu equipo:

{
  "mcpServers": {
    "agentready": {
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

VS Code (modo agente de GitHub Copilot)

Requiere VS Code 1.99+ con la extensión de GitHub Copilot. Crea .vscode/mcp.json en la raíz de tu proyecto:

{
  "servers": {
    "agentready": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

Las herramientas MCP de Copilot solo están disponibles en modo agente. Confirma este archivo para compartirlo con tu equipo.

Windsurf / Zed / otros clientes

Cualquier cliente MCP que admita transporte stdio funciona de la misma manera — usa npx -y @agentreadyweb/mcp como comando.

WebMCP (sin instalación)

Si tu cliente admite transporte HTTP, conéctate directamente por URL — no se requiere npm:

https://www.agentready.it.com/api/mcp

Plugin de Docusaurus

Si tu sitio de documentación usa Docusaurus, auto-indexa en cada compilación:

npm install @agentreadyweb/docusaurus-plugin

// docusaurus.config.js
plugins: [
  ['@agentreadyweb/docusaurus-plugin', { domain: 'docs.yoursite.com' }]
]

Plugin de MkDocs

Si tu sitio de documentación usa MkDocs, auto-indexa en cada compilación:

pip install mkdocs-agentready

# mkdocs.yml
plugins:
  - search
  - agentready

Si site_url no está configurado, especifica el dominio explícitamente:

plugins:
  - agentready:
      domain: docs.yoursite.com

Plugin de Starlight

Si tu sitio de documentación usa Starlight (Astro), auto-indexa en cada compilación:

npm install starlight-agentready

// astro.config.mjs
import agentready from 'starlight-agentready'

export default defineConfig({
  site: 'https://docs.yoursite.com',
  integrations: [
    starlight({
      plugins: [agentready()],
    }),
  ],
})

Extensión de Sphinx

Si tu sitio de documentación usa Sphinx, auto-indexa en cada compilación:

pip install sphinx-agentready

# conf.py
extensions = [
    "sphinx_agentready.extension",
]

# Domain is inferred from html_baseurl automatically, or set explicitly:
agentready_domain = "docs.yoursite.com"

Herramientas disponibles

list_sites

Lista todos los sitios web actualmente indexados por AgentReady con sus títulos y recuentos de páginas. Úsalo para verificar si un dominio ya está disponible antes de enviarlo.

get_site_capabilities

get_site_capabilities(domain: string)

Devuelve el manifiesto de capacidades del sitio, estado de frescura, esquemas y endpoints HTTP/MCP disponibles.

get_site_facts

get_site_facts(domain: string)

Devuelve hechos estructurados clave extraídos de un sitio — niveles de precios, listas de funciones, límites y otros puntos de datos de alta señal que los agentes necesitan con frecuencia.

plan_site_action

plan_site_action(domain: string, request: string)

Crea un plan de solo lectura fundamentado con evidencia, riesgos, requisitos de confirmación y un recibo duradero. No ejecuta efectos secundarios.

submit_site

submit_site(url: string)

Indexa cualquier sitio web con AgentReady. Tarda ~60 segundos. Maneja sitios estáticos, páginas renderizadas en servidor y SPAs con mucho JavaScript mediante un pipeline de cuatro capas. Una vez terminado, consúltalo con ask_site.

Ejemplo: submit_site("https://docs.example.com")

ask_site

ask_site(domain: string, query: string, url?: string)

Haz una pregunta sobre cualquier sitio web y obtén una respuesta citada fundamentada en su contenido. Sintetiza información de varias páginas. Si el sitio aún no está indexado, AgentReady lo rastrea e indexa automáticamente antes de responder (~60s).

Ejemplo: ask_site("stripe.com", "What are the fees for card payments?")

refresh_site

refresh_site(domain: string)

Fuerza un re-rastreo completo de un sitio para recoger contenido nuevo o modificado. Si el sitio es nuevo, AgentReady realiza su indexación inicial automáticamente. Tarda ~60 segundos.

Ejemplo: refresh_site("docs.example.com")

rate_answer

rate_answer(domain: string, rating: number, request_id?: string, comment?: string)

Envía comentarios de calidad de 1 a 5, opcionalmente vinculados a la solicitud exacta de ask_site.

Webhook de despliegue

Re-indexa automáticamente tu documentación en cada despliegue. No se requiere autenticación — limitado a una vez por hora por dominio.

curl -X POST https://www.agentready.it.com/api/webhook/refresh \
  -H "Content-Type: application/json" \
  -d '{"domain": "docs.yoursite.com"}'

O pasa el dominio como parámetro de consulta (funciona con cargas útiles de webhook codificadas en formularios de Vercel/Netlify):

https://www.agentready.it.com/api/webhook/refresh?domain=docs.yoursite.com

Cómo funciona la indexación

AgentReady usa un enfoque en capas para manejar cualquier sitio web público:

llms.txt / llms-full.txt — si el sitio publica uno, se usa como fuente de contenido estructurado de alta calidad
Rastreo HTML estándar — obtiene hasta 10 páginas mediante sitemap o rastreo de enlaces, extrae texto limpio
Extracción __NEXT_DATA__ — para aplicaciones Next.js, analiza datos renderizados en el servidor incrustados en el HTML
Respaldo de Jina Reader — para SPAs solo de JS que devuelven HTML vacío, usa un servicio de renderizado remoto para extraer contenido

Los sitios detrás de autenticación o sin contenido HTML público no pueden ser indexados.

Variables de entorno

Variable	Predeterminado	Descripción
`AGENTREADY_MCP_URL`	`https://www.agentready.it.com/api/mcp`	Sobrescribe el endpoint MCP (para autoalojamiento)
`AGENTREADY_TELEMETRY`	`1`	Configúralo en `0` para deshabilitar la telemetría de uso anónima

Telemetría

Este paquete envía un ping anónimo ligero a agentready.it.com/api/telemetry cada vez que el puente MCP se inicia o se ejecuta un comando CLI. Contiene: un ID de instalación aleatorio (almacenado en ~/.agentready/install-id), versión del paquete, versión de Node, plataforma y qué modo/comando se usó. Sin contenido de consultas, sin nombres de dominio, sin datos personales. Configura AGENTREADY_TELEMETRY=0 para optar por no participar.