Deinen Score verstehen
So funktioniert das Scoring
AgentGrade prüft 10 Capabilities in den Bereichen Payments, Discovery und Identity. Jede Capability hat Sub-Checks, die in zwei Stufen fallen:
- Verifiziert — AgentGrade hat einen Live-Request gesendet und bestätigt, dass die Capability funktioniert (z. B. MCP-Handshake abgeschlossen, OpenAPI-Spezifikation lieferte gültiges JSON)
- Deklariert — es wurde ein Manifest oder eine Konfigurationsdatei gefunden, die die Capability behauptet, sie wurde aber nicht unabhängig bestätigt
Verifizierte Checks werden in der Score-Berechnung 2x gewichtet. Eine Website, die funktioniert, ist mehr wert als eine Website, die nur behauptet zu funktionieren.
Die 10 Capabilities
Payments (höchstes Gewicht)
- Machine Payments — x402, MPP oder L402, erkannt über HTTP-402-Header
- Bazaar — x402.json-Service-Katalog mit auffindbaren Endpoints
Discovery
- MCP — Model-Context-Protocol-Endpoint (JSON-RPC 2.0)
- AI Plugin — ai-plugin.json-Manifest mit erreichbarer API-Spezifikation
- Claude Plugin — claude.json-Manifest mit gültigen Endpoints
- OpenAPI — openapi.json-Spezifikation, die gültiges JSON zurückgibt
- llms.txt — LLM-Kontextdatei, die mit einer H1-Überschrift beginnt
- Skills — skills.json-Manifest mit erreichbaren Endpoints
Informativ (geringeres Gewicht)
- agents.txt — Richtliniendatei für Agentenzugriff
- robots.txt — Agent-bewusste Direktiven für KI-Crawler
Optional (schaden deinem Score nicht)
- Identity — WebFinger, DID, Nostr NIP-05, AT Protocol DID
Score-Aufschlüsselung
Der Prozent-Score berechnet sich so: (Gewicht bestandener Checks / Gesamtgewicht aller Checks) × 100
Die Zusammenfassung zeigt „X / Y Checks bestanden", wobei Y optionale Checks ausschließt, die nicht gefunden wurden. Optionale Checks (Identity-Protokolle) können deinen Score nur verbessern, nie verschlechtern.
So verbesserst du deinen Score
- Zuerst Discovery-Dateien hinzufügen —
/openapi.jsonund/llms.txtsind die einfachsten Gewinne - Sicherstellen, dass sie funktionieren — eine erreichbare, gültige OpenAPI-Spezifikation bringt dir verifizierte Checks, nicht nur deklarierte
- MCP hinzufügen — der MCP-Handshake (initialize → tools/list → tools/call) bringt gleich mehrere verifizierte Checks
- Payment-Unterstützung hinzufügen — x402- oder MPP-Header auf mindestens einem Endpoint aktivieren die Capability „Machine Payments"
- Service-Katalog veröffentlichen —
/.well-known/x402.jsonmit auffindbaren Endpoints bringt Bazaar-Checks