getAdvantage MCP Server

Autenticación

Crea una clave en /app/api-keys (se muestra una sola vez — guárdala como un secreto de entorno, nunca la subas al repositorio). Envíala como token Bearer en cualquier solicitud:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"
-H "Authorization: Bearer adv_live_…"

Sin el encabezado obtienes el nivel gratuito sin clave (límite por IP, salida muestreada). Con una clave, el límite sigue tu plan y un plan de pago devuelve salida del modelo en vivo. Superar el límite devuelve HTTP 429 con un encabezado retry-after; una clave inválida devuelve 401.

Límites de uso

Los límites se aplican por clave (o por IP, sin clave) en el momento de la solicitud:

• Sin clave: 5/min · 30/día, salida muestreada
• Starter: 60/min · 1,000/día, salida en vivo
• Pro: 120/min · 5,000/día, salida en vivo
• Agency: 240/min · 20,000/día (uso justo), salida en vivo

El endpoint combinado cuenta como un solo tick a la misma tasa por motor (nunca cobra tres veces por una llamada).

Endpoints

GET/api/analyze?url=

Get Found — escaneo de legibilidad para IA (9 señales)

Puntúa qué tan legible es la página para motores de IA en nueve señales (título, meta descripción, datos estructurados, encabezados, llms.txt, relación contenido/marcado, Open Graph, canónica, robots). Devuelve un desglose por señal, correcciones listas para pegar y un llms.txt inicial generado.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET/api/verify-convert?url=

Convert — preparación para conversión + lectura en frío de 5 segundos

Puntúa las señales que determinan si un visitante nuevo entiende la aplicación y se registra. Con una clave de pago también ejecuta una prueba agéntica de primera impresión de 5 segundos. Devuelve verificaciones, correcciones, un percentil de referencia y un informe /v compartible.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET/api/verify-safety?url=

Ship Verified — verificaciones de seguridad para despliegue + insignia

Ejecuta verificaciones deterministas para exposiciones comunes de código generado por "vibe-coding" (secretos en el bundle del cliente, configuración del backend, archivos expuestos, encabezados de seguridad, CORS, transporte, mapas de origen). Una verificación aprobada significa que no encontramos ese problema específico — nunca que la aplicación sea segura o esté certificada. Devuelve verificaciones, correcciones, un percentil de referencia, un informe /v y una insignia "Checked by Advantage".

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST/api/v1/scan/combined

Combined — los tres motores, una sola llamada

Ejecuta los tres motores sobre una URL y devuelve una carga útil: tres bloques de puntuación independientes (nunca promediados), un resumen de intersección que nombra la dimensión más débil y el siguiente paso más importante, y un enlace permanente. La forma más rápida de obtener la imagen completa en una sola solicitud.

curl -X POST "https://getadvantage.app/api/v1/scan/combined"
-H "Content-Type: application/json"
-H "Authorization: Bearer adv_live_…"
-d '{"url":"https://yourapp.com"}'

Servidor MCP — escanea desde tu editor

Advantage también es un servidor de Model Context Protocol, por lo que puedes agregarlo una vez a Claude Code, Cursor, Claude Desktop o Windsurf y simplemente escribir "scan my app with getadvantage". Utiliza HTTP Transmisible Remoto (el transporte remoto oficial actual) — cero instalación, los escaneos se ejecutan en nuestros servidores. Expone cuatro herramientas: get_found, convert_check, ship_verified y combined_scan. Cada una comienza con la puntuación y la corrección más importante lista para pegar, e incluye el enlace al informe.

Agregarlo (Cursor / Claude Desktop / Claude Code)

Agrega esto en la configuración de tu cliente MCP:

{ "mcpServers": { "getadvantage": { "url": "https://getadvantage.app/api/mcp" } } }

Con una clave de API (mayor límite, salida en vivo), agrega el encabezado:

{ "mcpServers": { "getadvantage": { "url": "https://getadvantage.app/api/mcp", "headers": { "Authorization": "Bearer adv_live_…" } } } }

O, en Claude Code, una línea:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

El servidor MCP es gratuito para probar sin clave con el límite sin clave; una clave aumenta el límite y devuelve salida en vivo, exactamente como la API HTTP.

¿Quieres rastrear sitios, ver el historial y aplicar correcciones automáticamente mediante el embed? Crea una cuenta — o escanea una aplicación gratis primero.

Pregúntale a Ray