getAdvantage MCP Server

Authentifizierung

Erstellen Sie einen Schlüssel unter /app/api-keys (wird nur einmal angezeigt – speichern Sie ihn als Umgebungs-Secret, committen Sie ihn niemals). Senden Sie ihn als Bearer-Token bei jeder Anfrage:

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

Ohne den Header erhalten Sie das schlüssellose kostenlose Kontingent (pro-IP-Rate, reduzierte Ausgabe). Mit einem Schlüssel richtet sich die Rate nach Ihrem Tarif, und ein kostenpflichtiger Tarif liefert Live-Modell-Ausgaben. Bei Überschreitung des Limits wird HTTP 429 mit einem retry-after-Header zurückgegeben; ein ungültiger Schlüssel führt zu 401.

Ratenlimits

Limits werden pro Schlüssel (oder pro IP, schlüssellos) zum Zeitpunkt der Anfrage eingehalten:

• Schlüssellos: 5/Min · 30/Tag, reduzierte Ausgabe
• Starter: 60/Min · 1.000/Tag, Live-Ausgabe
• Pro: 120/Min · 5.000/Tag, Live-Ausgabe
• Agency: 240/Min · 20.000/Tag (Fair-Use), Live-Ausgabe

Der kombinierte Endpunkt zählt als ein Tick zur gleichen Pro-Engine-Rate (er berechnet niemals das Dreifache für einen Aufruf).

Endpunkte

GET/api/analyze?url=

Get Found – KI-Lesbarkeitsscan (9 Signale)

Bewertet, wie lesbar die Seite für KI-Engines ist, anhand von neun Signalen (Titel, Meta-Beschreibung, strukturierte Daten, Überschriften, llms.txt, Verhältnis Inhalt zu Markup, Open Graph, Canonical, Robots). Liefert eine Aufschlüsselung pro Signal, einfügefertige Korrekturen und eine generierte Starter-llms.txt.

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

GET/api/verify-convert?url=

Convert – Conversion-Bereitschaft + 5-Sekunden-Kaltlesetest

Bewertet die Signale, die darüber entscheiden, ob ein Erstbesucher die App versteht und sich anmeldet. Mit einem kostenpflichtigen Schlüssel wird zusätzlich ein agentenbasierter 5-Sekunden-Ersteindruckstest durchgeführt. Liefert Prüfungen, Korrekturen, ein Benchmark-Perzentil und einen teilbaren /v-Bericht.

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

GET/api/verify-safety?url=

Ship Verified – Prüfungen zur Auslieferungssicherheit + Badge

Führt deterministische Prüfungen auf häufige, durch Vibe-Coding verursachte Schwachstellen durch (Secrets im Client-Bundle, Backend-Konfiguration, exponierte Dateien, Sicherheitsheader, CORS, Transport, Source Maps). Eine bestandene Prüfung bedeutet, dass wir dieses spezifische Problem nicht gefunden haben – niemals, dass die App sicher oder zertifiziert ist. Liefert Prüfungen, Korrekturen, ein Benchmark-Perzentil, einen /v-Bericht und ein „Checked by Advantage“-Badge.

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

POST/api/v1/scan/combined

Combined – alle drei Engines, ein Aufruf

Führt alle drei Engines über eine URL aus und liefert eine Payload: drei unabhängige Bewertungsblöcke (niemals gemittelt), eine Schnittmengen-Zusammenfassung, die die schwächste Dimension und den wichtigsten nächsten Schritt benennt, sowie einen Permalink. Der schnellste Weg, das Gesamtbild mit einer einzigen Anfrage zu erhalten.

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

MCP-Server – Scannen direkt aus Ihrem Editor

Advantage ist auch ein Model Context Protocol-Server, sodass Sie ihn einmal zu Claude Code, Cursor, Claude Desktop oder Windsurf hinzufügen und einfach “scan my app with getadvantage” eingeben können. Er nutzt entferntes Streamable HTTP (den aktuellen offiziellen Remote-Transport) – keine Installation, die Scans laufen auf unseren Servern. Er stellt vier Werkzeuge bereit: get_found, convert_check, ship_verified und combined_scan. Jedes beginnt mit der Bewertung und der wichtigsten einfügefertigen Korrektur und enthält den Berichtslink.

Hinzufügen (Cursor / Claude Desktop / Claude Code)

Fügen Sie dies in Ihre MCP-Client-Konfiguration ein:

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

Mit einem API-Schlüssel (höhere Rate, Live-Ausgabe) fügen Sie den Header hinzu:

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

Oder, in Claude Code, eine Zeile:

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

Der MCP-Server kann ohne Schlüssel mit der schlüssellosen Rate kostenlos getestet werden; ein Schlüssel erhöht die Rate und liefert Live-Ausgaben, genau wie die HTTP-API.

Möchten Sie Websites verfolgen, den Verlauf einsehen und Korrekturen automatisch über das Embed anwenden? Erstellen Sie ein Konto – oder scannen Sie zuerst eine App kostenlos.

Ask Ray