authorized.by MCP Server

Welche Fragen sind möglich?

Nach dem Verbinden lassen sich zum Beispiel folgende Fragen stellen:

• „Ist santosgrills.de ein autorisierter Händler von Napoleon (napoleon.com)?“
• „Ich habe das Produkt mit der GTIN 00629162151315 bei santosgrills.de gefunden – ist der Shop dafür autorisiert?“
• „Zeige fünf autorisierte Deuter-Händler mit ihren Shop-Domains.“
• „Für welche Marken ist santosgrills.de autorisiert? Bitte mit Zertifikatslinks.“
• „Zeige mir das Händlerprofil und die Öffnungszeiten von santosgrills.de.“

Die Ergebnisse geben den Datenstand zum Zeitpunkt der Abfrage wieder und können sich ändern.

Autorisierung direkt prüfen

Für die Frage „Ist Shop X von Marke Y autorisiert?“ genügt ein einziger Aufruf: verify_retailer_authorization. Das Tool erwartet die Shop-Domain und wahlweise die Marke oder die Produktnummer.

Wenn die direkte Prüfung nicht greift

Für breitere Recherche oder bei unklarer Domain führt der zweistufige Weg zum Ziel:

1. Händler über get_retailers nach Firmenname oder Alias suchen.
2. Zurückgegebene shop_url mit der geprüften Domain abgleichen.
3. Die gelieferte Händler-ID oder den Slug mit get_retailer_brands verwenden.
4. Nur die konkret zurückgegebenen Markenbeziehungen ausweisen, jeweils mit Zertifikatslink.

Ähnlich benannte Shops sind nicht zwangsläufig dasselbe Unternehmen. Umgekehrt liefert get_brand_retailers alle aktuell von einer Marke autorisierten Händler.

Client verbinden

Jeder Client, der Remote-MCP-Server über Streamable HTTP unterstützt, kann den oben genannten Endpunkt nutzen. Wählen Sie keine Authentifizierung und richten Sie sich für das genaue Konfigurationsformat nach der Dokumentation Ihres Clients.

claude mcp add --transport http authorized-by https://app.authorized.by/api/public/mcp

{
  "mcpServers": {
    "authorized-by": {
      "url": "https://app.authorized.by/api/public/mcp"
    }
  }
}

{
  "servers": {
    "authorized-by": {
      "type": "http",
      "url": "https://app.authorized.by/api/public/mcp"
    }
  }
}

Prüfe mit authorized.by, ob santosgrills.de ein autorisierter Händler von Napoleon ist. Nenne den zurückgegebenen Status, das Startdatum und den Zertifikatslink.

Verfügbare Tools

Sieben Tools: eines für die direkte Prüfung einer Autorisierung, sechs für die Recherche in beide Richtungen – von Marken zu ihren autorisierten Händlern und von Händlern zu den autorisierenden Marken.

Bei den Such-Tools beginnt die Seitenzählung bei 0. Die dokumentierte Standard-Seitengröße beträgt 500. Über die Paginierungsangaben lässt sich erkennen, ob weitere Ergebnisse vorliegen. Die Filter search berücksichtigen auch Domains und URLs. Einzelne Profilfelder können leer sein, wenn keine Angaben vorliegen.

Ergebnisse richtig einordnen

Händlerlisten aus get_brand_retailers sind nach Paketstufe sortiert – PREMIUM, START, FREE – und anschließend nach der Anzahl der Markenverbindungen. Diese Reihenfolge ist keine Qualitätsrangfolge.

Technische Details

API-Beispiele für Entwickler

Die folgenden Aufrufe verwenden JSON-RPC 2.0 über HTTP POST. Die Antwort enthält neben content auch structuredContent.

curl -s https://app.authorized.by/api/public/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -s https://app.authorized.by/api/public/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_brand","arguments":{"id_or_alias":"deuter"}}}'

Die Beispiele zeigen die vom Markdown dokumentierten Aufrufe. Für Clients mit Protokollversion 2026-07-28 sind zusätzlich die dort beschriebenen _meta-Felder und Header erforderlich.

Nutzungshinweise

Die öffentlichen Daten dienen zur Recherche und Prüfung von Marken-Händler-Autorisierungen. Beachten Sie das Rate Limit und speichern Sie Ergebnisse bei Bedarf mit dokumentiertem Abrufzeitpunkt zwischen.