Skip to main content
Glama

AON MCP Server

Geben Sie jedem MCP-fähigen Agenten die Möglichkeit, echte, kaufbare Produkte und Dienstleistungen zu empfehlen — mit Live-Preisen und einem nachverfolgbaren Link zu jedem Angebot, bezogen aus dem Agent Offer Network.

  • Endpunkt: POST https://api.aon.pro/v1/mcp

  • Transport: Streamable HTTP (zustandsloses JSON-RPC 2.0 — kein SSE, kein Session-Handshake)

  • Authentifizierung: Authorization: Bearer <AON API key> — kostenlose Schlüssel im Developer Portal

  • Jetzt ausprobieren: Ein gemeinsamer öffentlicher Demo-Schlüssel ist im Quick Start veröffentlicht — ein curl, keine Anmeldung

  • Dokumentation: docs.aon.pro/mcp

Tools

Tool

Was es tut

aon_search_offers

Sucht Angebote anhand von natürlichsprachlicher Absicht. Die Argumente sind ein AgentOffer Query-Anfrageobjekt — in derselben Form wie bei der REST-API. Gibt Angebote mit Preisen, jeweils einem Tracking-Link und einem engagement-Block mit vorvalidierten Folgeempfehlungen zurück, auf die der Agent reagieren kann.

aon_resolve_category

Wandelt Freitext („Wanderschuhe", „Team-Chat-Software") in Kategorie-IDs der AON Taxonomy v1 um — das Modell muss sie sich nie merken oder erfinden.

aon_get_category_schema

Ruft die Entscheidungsfaktoren ab, die Käufer innerhalb einer Kategorie abwägen, um vor der Suche die richtige Klärungsfrage zu stellen.

aon_submit_feedback

Erfasst eine explizite „Verworfen"- / „Nicht interessiert"-Angabe des Benutzers zu einem Angebot — niemals aus Schweigen abgeleitet. Frühes Gerüst: Der Aufruf wird mit Erfolg bestätigt, aber das Feedback wird noch nicht persistiert; der dahinterstehende Workflow wird ausgerollt.

aon_manage_watch

Stellt die Standard-Überwachung (watch) eines Angebots oder einer Kategorie wieder her oder bricht sie ab (unwatch), wenn der Benutzer dies explizit verlangt. Frühes Gerüst: Mit Erfolg bestätigt, Überwachungsstatus wird noch nicht persistiert.

Designhinweise, von denen Agenten profitieren:

  • Nachsichtig im Design — Ungültige Werte lassen eine Suche nie fehlschlagen; sie werden als „nicht gesendet" behandelt und in extra.hints[] korrigiert. Nur fehlerhafte Authentifizierung, ungültiges JSON, ein fehlendes intent.content oder ein zu großer Body führen zu einem harten Fehlschlag.

  • Relevanz-gesteuert — Eine leere Ergebnisliste ist eine echte Antwort, niemals Füllmaterial.

  • Führungsschleife — Folgeempfehlungen tragen einen RFC 7386 request_patch, der direkt in den nächsten Aufruf einfließt, sowie einen origin, der zur Zuordnung der Übernahme zurückgespiegelt wird.

Related MCP server: Agentic Travel Recommendations Service

Schnellstart

curl -s -X POST https://api.aon.pro/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AON_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "aon_search_offers",
      "arguments": {
        "intent": {
          "content": [
            { "type": "input_text", "text": "credit card with cashback" }
          ]
        }
      }
    },
    "id": 1
  }'

Noch keinen Schlüssel? Kopieren Sie den gemeinsamen Demo-Schlüssel aus dem Quick Start in $AON_API_KEY.

Client-Einrichtung

Direkt einfügbare Konfigurationen finden Sie in examples/:

Client

Konfiguration

Claude Code

examples/claude-code

Claude Desktop

examples/claude-desktop (über mcp-remote)

Cursor

examples/cursor

VS Code

examples/vscode

Einfaches curl

examples/curl

Ratenbegrenzungen

/v1/mcp erlaubt 60 tools/call-Anfragen pro Minute und Schlüssel; Handshake-Aufrufe (initialize, tools/list, notifications/*) werden nie gezählt. Ein über dem Limit liegender tools/call gibt HTTP 200 mit dem JSON-RPC-Fehler -32000 zurück, damit das Modell den Wiederholungs-Hinweis lesen kann. Details: Ratenbegrenzungen & FAQ.

Monetarisierung & Zuordnung

Jedes Angebot trägt einen nachverfolgbaren Ziel-Link (action.payload.target). Geben Sie ihn unverändert aus — Klicks und Conversions werden der Anwendung Ihres API-Schlüssels zugeordnet, was die Grundlage für die Umsatzbeteiligung der Entwickler ist. Berichte finden Sie im Developer Portal.

Registry-Manifest

server.json ist das MCP-Registry-Manifest für diesen Server (Schema 2025-12-11, Namespace pro.aon — DNS-verifiziert gegen die aon.pro-Domain).

Verwandte Repositorys

  • protocol — AgentOffer-Protokollspezifikationen (normativ)

  • schema — JSON-Schemas, TypeScript-Typen, Taxonomie

  • examples — HTTP-/SDK-/Agenten-Integrationsbeispiele

  • rfcs — Vorschläge zur Protokollweiterentwicklung

Lizenz

Apache-2.0

Related MCP Connectors

Related MCP Servers