MCP y API

Mide la visibilidad en IA desde Claude, tus agentes y tu pipeline.

AeoState ejecuta un servidor Model Context Protocol (MCP) en https://aeostate.com/mcp, con la misma API HTTP detrás. Conéctate una vez y la puntuación gratuita de visibilidad en IA se muestra como una tarjeta interactiva en Claude Desktop, claude.ai, Claude Code, Cursor y cualquier otro host MCP, o llama a la API directamente desde un script.

Herramientas

Las herramientas gratuitas funcionan para cualquiera: sin cuenta ni clave. Las marcadas como “Clave de API” actúan en nombre de una cuenta registrada: crea una cuenta gratuita y luego una clave personal en Cuenta → Acceso API.

Conéctate en un paso

Copia uno de estos fragmentos en tu host. Añade la cabecera Authorization cuando tengas una clave.

Endpoint MCP
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor, VS Code, conectores de claude.ai y otros hosts (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
Lo mismo, actuando con tu cuenta
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

HTTP sencillo para pipelines

Las mismas tres llamadas que hace el servidor MCP. Inicia un análisis, consúltalo y lee el informe, desde CI, un flujo de CRM o una tarea nocturna.

1 · Iniciar un análisis
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · Consultar hasta que termine
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · Leer el informe
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

Los análisis anónimos siguen las reglas de la puntuación gratuita del sitio (límites de uso; donde la puntuación gratuita está protegida por correo, el enlace se envía por email). Con una clave se ejecutan como tu cuenta: sin puerta, límites por clave y tus informes de pago.

Cómo encuentran los agentes de IA a AeoState

Además del servidor MCP, AeoState publica descripciones legibles por máquinas para que los agentes de IA y los registros de agentes lo descubran por sí mismos. Cada dirección de abajo responde con JSON que cualquier sitio puede leer.

Tarjeta del servidor MCP
https://aeostate.com/.well-known/mcp/server-card.json
Catálogo de IA (ARD)
https://aeostate.com/.well-known/ai-catalog.json
Catálogo de API (RFC 9727)
https://aeostate.com/.well-known/api-catalog

Skills para agentes (Agent Skills)

Los agentes compatibles con Agent Skills pueden cargar desde este índice la skill que publica AeoState. Les enseña a ejecutar una comprobación gratuita de visibilidad en IA mediante el servidor MCP o la API HTTP y a leer el resultado. Cada skill aparece con un resumen SHA-256 para que el agente pueda verificar lo que ha descargado.

Índice de Agent Skills
https://aeostate.com/.well-known/agent-skills/index.json

Páginas en markdown

Pide cualquier página pública con la cabecera Accept: text/markdown para obtener su texto en markdown en lugar de HTML, con su título, dirección e idioma al principio. Los navegadores siguen recibiendo la página normal.

Ejemplo
curl -H "Accept: text/markdown" https://aeostate.com/es/pricing

Herramientas en el navegador (WebMCP)

En un navegador compatible con WebMCP, un agente de IA que trabaje en este sitio puede abrir sus páginas, consultar los precios actuales, seguir un análisis en curso y rellenar el formulario de puntuación gratuita. El visitante sigue confirmando y enviando el formulario. WebMCP es experimental y solo está disponible en algunas versiones de navegador; en los demás no cambia nada.

Puntuación gratuita frente a Informe Advanced

Sin cuenta

Puntuación gratuita: todas las herramientas, cualquier visitante

  • Tu puntuación global de visibilidad, su calificación y nuestra confianza en ella
  • Qué rastreadores de IA pueden y no pueden acceder a tu sitio
  • El primer hallazgo que frena tu visibilidad

Obtén una clave de API personal

Inicia sesión (o crea una cuenta gratuita), abre Cuenta → Acceso API, crea una clave y pégala en los fragmentos de arriba. Las claves solo actúan sobre análisis y los informes que compraste, nunca sobre tu cuenta, la facturación ni los informes de otros.

Obtén tu clave