getAdvantage MCP Server

Authentification

Créez une clé sur /app/api-keys (affichée une seule fois — conservez-la comme secret d’environnement, ne la commitez jamais). Envoyez-la comme jeton Bearer sur toute requête :

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

Sans l’en-tête, vous obtenez le niveau gratuit sans clé (débit par IP, sortie échantillonnée). Avec une clé, le débit suit votre forfait et un forfait payant renvoie la sortie du modèle en direct. En cas de dépassement de limite, la réponse est HTTP 429 avec un en-tête retry-after ; une clé invalide renvoie 401.

Limites de débit

Les limites sont appliquées par clé (ou par IP, sans clé) au moment de la requête :

• Sans clé : 5/min · 30/jour, sortie échantillonnée
• Starter : 60/min · 1 000/jour, sortie en direct
• Pro : 120/min · 5 000/jour, sortie en direct
• Agency : 240/min · 20 000/jour (usage raisonnable), sortie en direct

L’endpoint combiné compte pour un seul appel au même débit par moteur (il ne facture jamais trois fois pour un seul appel).

Endpoints

GET/api/analyze?url=

Get Found — Analyse de lisibilité IA (9 signaux)

Évalue la lisibilité de la page pour les moteurs d’IA sur neuf signaux (titre, meta description, données structurées, titres, llms.txt, ratio contenu/balisage, Open Graph, canonique, robots). Renvoie une ventilation par signal, des correctifs prêts à coller et un fichier llms.txt de démarrage généré.

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

GET/api/verify-convert?url=

Convert — Préparation à la conversion + lecture à froid en 5 secondes

Évalue les signaux qui déterminent si un visiteur débutant comprend l’application et s’inscrit. Avec une clé payante, il exécute également un test agentique de première impression en 5 secondes. Renvoie des vérifications, des correctifs, un percentile de référence et un rapport /v partageable.

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

GET/api/verify-safety?url=

Ship Verified — Vérifications de sécurité de mise en production + badge

Exécute des vérifications déterministes pour les expositions courantes liées au code généré par IA (secrets dans le bundle client, configuration backend, fichiers exposés, en-têtes de sécurité, CORS, transport, source maps). Une vérification réussie signifie que nous n’avons pas trouvé ce problème spécifique — jamais que l’application est sécurisée ou certifiée. Renvoie des vérifications, des correctifs, un percentile de référence, un rapport /v et un badge « Checked by Advantage ».

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

POST/api/v1/scan/combined

Combined — Les trois moteurs, un seul appel

Exécute les trois moteurs sur une seule URL et renvoie une charge utile unique : trois blocs de score indépendants (jamais moyennés), un résumé croisé nommant la dimension la plus faible et la meilleure action suivante, ainsi qu’un permalien. Le moyen le plus rapide d’obtenir une vue d’ensemble en une seule requête.

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"}'

Serveur MCP — analysez depuis votre éditeur

Advantage est également un serveur Model Context Protocol, vous pouvez donc l’ajouter une fois à Claude Code, Cursor, Claude Desktop ou Windsurf et simplement taper “scan my app with getadvantage”. Il utilise le protocole HTTP Streamable distant (le transport distant officiel actuel) — zéro installation, les analyses s’exécutent sur nos serveurs. Il expose quatre outils : get_found, convert_check, ship_verified et combined_scan. Chacun commence par le score et le correctif le plus important prêt à coller, et inclut le lien du rapport.

Ajoutez-le (Cursor / Claude Desktop / Claude Code)

Insérez ceci dans la configuration de votre client MCP :

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

Avec une clé API (débit plus élevé, sortie en direct), ajoutez l’en-tête :

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

Ou, dans Claude Code, une seule ligne :

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

Le serveur MCP est gratuit à essayer sans clé au débit sans clé ; une clé augmente le débit et renvoie la sortie en direct, exactement comme l’API HTTP.

Vous voulez suivre des sites, voir l’historique et appliquer automatiquement des correctifs via l’intégration ? Créez un compte — ou analysez d’abord une application gratuitement.

Ask Ray