Bynn Intelligence

Bynn MCP

Verbinden Sie jeden MCP-kompatiblen KI-Client mit Bynn: Identitätsprüfung (KYC), Dokumentenbetrugserkennung, Altersverifikation, Inhaltsmoderation, Gesichtssuche, AutoDoc-Workflows, Betrugsanalyse-Agenten und Kontoverwaltung. 143 Tools über die Bynn-API, eine Verbindung. Funktioniert in Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf und Zed.

https://mcp.bynn.com

Der Endpunkt ist der Root-Pfad. Hängen Sie /mcp nicht an; https://mcp.bynn.com/mcp wird nicht funktionieren. Die einzige andere Route ist GET /health.

---

Schnellstart (30 Sekunden)

Claude Code:

claude mcp add --transport http bynn https://mcp.bynn.com

Claude oder ChatGPT (gehostet): Fügen Sie https://mcp.bynn.com als benutzerdefinierten Connector hinzu und melden Sie sich mit Ihrem Bynn-Konto an, wenn der Browser geöffnet wird. Keine Schlüsselverwaltung erforderlich.

API-basierte Clients: Holen Sie sich ein Token unter dashboard.bynn.com/authenticate und senden Sie es als Authorization: Bearer <token> bei der Verbindung.

Dann versuchen Sie Ihren ersten Prompt:

Check whether this image is AI-generated.

Fügen Sie ein Bild hinzu, und das Ergebnis wird als interaktive Karte mit dem Urteil, der KI-Wahrscheinlichkeit und dem wahrscheinlichsten Generator angezeigt.

---

Beispiel-Prompts

Betrug und Dokumente

Submit this bank statement for fraud analysis and summarize the risk when it finishes.
Is this invoice manipulated? Show me the forensic findings.
Run my passport-fraud orchestrator against the latest analyzed document.

Verifizierung

Create a KYC verification session for this applicant and give me the hosted link.
Estimate the age of the person in this photo and tell me if they look under 25.
Create an age verification session with liveness for user 8841.

Moderation und Medien

Check whether this image is AI-generated.
Which moderation models can I run on video?
Search this face against my employees collection.

Konto und Betrieb

List my API keys and when they were last used.
Rotate my live private key but keep the grace period.
Show this month's usage and my latest invoices.

Dokumentenbetrugs- und KI-Bild-Ergebnisse werden in ChatGPT und Claude als interaktive Karten angezeigt (siehe Interaktive Widgets).

---

Installation

Claude Code

claude mcp add --transport http bynn https://mcp.bynn.com

Claude Desktop und claude.ai

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → URL https://mcp.bynn.com. Die OAuth-Anmeldung startet automatisch bei der ersten Nutzung.

ChatGPT

Einstellungen → Apps & Connectors → Entwicklermodus aktivieren → Erstellen → MCP-Server-URL https://mcp.bynn.com. Bynn ist als ChatGPT-App gebaut: Betrugsberichte und KI-Bild-Prüfungen werden als interaktive Karten angezeigt, und angehängte Bilder werden nativ an die Tools weitergeleitet.

Cursor

Ein Klick oben, oder manuell zu ~/.cursor/mcp.json (oder .cursor/mcp.json pro Projekt) hinzufügen:

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com"
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "bynn": {
      "type": "http",
      "url": "https://mcp.bynn.com"
    }
  }
}

Windsurf

Windsurf verbindet sich über die mcp-remote-Brücke:

{
  "mcpServers": {
    "bynn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
    }
  }
}

Zed

settings.json → context_servers:

{
  "context_servers": {
    "bynn": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
      }
    }
  }
}

---

Authentifizierung

OAuth 2.1 (Connectors)

Gehostete Connectors (Claude, ChatGPT) authentifizieren sich mit OAuth 2.1 + PKCE. Der Autorisierungsserver ist dashboard.bynn.com; Ihr MCP-Client öffnet eine Browser-Anmeldung, Sie genehmigen die angeforderten Berechtigungen, und der Client verbindet sich als Ihr Bynn-Dashboard-Benutzer. Clients, die Dynamic Client Registration unterstützen (Claude, Cursor), registrieren sich automatisch.

Bearer-Tokens (API-basierte Clients)

Für serverseitige, skriptbasierte oder selbst gehostete Nutzung senden Sie einen Autorisierungs-Header bei der MCP-Verbindung:

Authorization: Bearer <token>

Holen Sie sich ein Token unter dashboard.bynn.com/authenticate. Drei Token-Typen funktionieren:

Token	Präfix	Was es tun kann
Dashboard-Token (JWT)	keine	Alles. Wenn ein Tool einen API-Schlüssel benötigt, tauscht der Server das JWT automatisch gegen die Schlüssel Ihrer Organisation.
Privater API-Schlüssel	private_...	Produkt- und Verifizierungs-Tools (Dokumente, Moderation, Altersergebnisse). Nicht ausreichend für Dashboard-Tools wie API-Schlüssel oder Abrechnung.
Öffentlicher API-Schlüssel	public_...	Client-sichere Sitzungserstellung (create_session, create_age_verification_session).

Pro Tool-Gruppe:

Tool-Gruppe	Mindestanmeldedaten
API-Schlüssel, Abrechnung, Benutzer, AutoDoc, Reasoning, Websites	Dashboard-Token (JWT)
Dokumente, Moderation, Gesicht, NFC	Privater Schlüssel oder JWT
create_session, create_age_verification_session	Öffentlicher Schlüssel oder JWT
verify_age_from_selfie, get_age_verification_result	Privater Schlüssel oder JWT
Sitzungsschritte (Einwilligung, Preflight, Liveness, Uploads)	Keine: Das Sitzungstoken in der URL ist die Anmeldeinformation

Verwenden Sie private Schlüssel nur in vertrauenswürdigen serverseitigen Umgebungen. Setzen Sie sie niemals in Frontend-Code, öffentlichen Repositories oder geteilten Chats ein.

Beispiel-Client-Konfiguration mit einem Token

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com",
      "headers": {
        "Authorization": "Bearer ${BYNN_API_KEY}"
      }
    }
  }
}

export BYNN_API_KEY="private_your_bynn_key_here"

---

Tools-Referenz (143 Tools)

Zugriffs-Badges: Lesen = sicher, nicht verändernd. Schreiben = erstellt oder ändert Daten. Destruktiv = löscht, storniert oder widerruft (delete_*, cancel_*, rotate_api_key); halten Sie die Bestätigung für diese in Ihrem Client aktiviert. Jedes Tool trägt auch maschinenlesbare readOnlyHint / destructiveHint-Annotationen, sodass MCP-Clients sie automatisch steuern können.

Dokumente (4)

Tool	Zugriff	Beschreibung
delete_document	Destruktiv	Löschen Sie eine Dokumenteneinreichung.
get_document	Lesen	Rufen Sie eine Dokumenteneinreichung und ihr forensisches Analyseergebnis ab.
list_documents	Lesen	Listen und durchsuchen Sie Ihre Dokumenteneinreichungen.
submit_document	Schreiben	Reichen Sie ein Dokument zur vollständigen Betrugs-/Authentizitätsanalyse ein.

Die Dokumentenanalyse ist asynchron: submit_document, dann poll get_document, bis status analyzed ist.

Altersverifikation (5)

Tool	Zugriff	Beschreibung
complete_age_verification_liveness	Schreiben	Schließen Sie eine Liveness-Erfassung ab.
create_age_verification_session	Schreiben	Erstellen Sie eine neue Liveness-Altersverifikationssitzung.
get_age_verification_result	Lesen	Lesen Sie das Ergebnis einer Liveness-Altersverifikationssitzung.
start_age_verification_liveness	Schreiben	Starten Sie die Liveness-Erfassung für eine Sitzung.
verify_age_from_selfie	Schreiben	Schätzen Sie das Alter aus einem einzelnen Selfie, ohne Liveness.

verify_age_from_selfie nimmt einen age_verification_model-Schwellenwert (21, 18 und niedriger, Standard 18) plus ein legal_age_21-Zuständigkeitsflag. Der Liveness-Ablauf ist: Sitzung erstellen → Liveness starten → Liveness abschließen → Ergebnis abrufen.

Inhaltsmoderation (12)

Tool	Zugriff	Beschreibung
check_age	Schreiben	Schätzen Sie das Alter von Gesichtern in einem Bild (Altersverifikation / Minderjährigenerkennung).
create_moderation_inference	Schreiben	Führen Sie eine Moderation-/KI-Erkennungsinferenz aus.
detect_ai_generated_image	Schreiben	Prüfen Sie, ob ein Bild KI-generiert oder ein echtes Foto ist.
get_moderation_dashboard_stats	Lesen	Rufen Sie Moderations-Dashboard-Statistiken für Ihre Organisation ab.
get_moderation_inference	Lesen	Rufen Sie eine frühere Moderationsinferenz anhand ihrer ID ab.
get_moderation_model	Lesen	Holen Sie sich ein Moderationsmodell mit vollständiger Dokumentation.
list_all_moderation_models	Lesen	Listen Sie ALLE öffentlichen Moderationsmodelle über jeden Typ auf.
list_audio_moderation_models	Lesen	Listen Sie AUDIO-Moderationsmodelle gruppiert nach Kategorie auf.
list_image_moderation_models	Lesen	Listen Sie BILD-Moderationsmodelle gruppiert nach Kategorie auf.
list_text_moderation_models	Lesen	Listen Sie TEXT-Moderationsmodelle gruppiert nach Kategorie auf.
list_video_moderation_models	Lesen	Listen Sie VIDEO-Moderationsmodelle gruppiert nach Kategorie auf.
public_moderation_inference	Schreiben	Führen Sie eine KOSTENLOSE öffentliche KI-Erkennungsinferenz aus, keine Anmeldedaten erforderlich.

detect_ai_generated_image gibt result.is_ai_generated (das Urteil), ai_probability, uncertain, top_generator, generators, c2pa_signer und detection_mode zurück. check_age gibt pro Gesicht age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty und bbox zurück.

Gesichtssuche (6)

Tool	Zugriff	Beschreibung
create_face_collection	Schreiben	Erstellen Sie eine neue Gesichtssammlung.
delete_face	Destruktiv	Löschen Sie ein einzelnes registriertes Gesicht aus einer Sammlung.
delete_face_collection	Destruktiv	Löschen Sie eine Gesichtssammlung und ALLE ihre registrierten Gesichter.
enroll_face	Schreiben	Registrieren Sie ein einzelnes Gesicht in einer Sammlung.
list_face_collections	Lesen	Listen Sie die Gesichtssammlungen Ihrer Organisation auf.
search_faces	Lesen	Durchsuchen Sie eine Sammlung nach Gesichtern, die einem Probe-Bild ähnlich sind.

AutoDoc (37)

Tool	Zugriff	Beschreibung
add_dossier_note	Schreiben	Einen Admin-Hinweis zu einer Akte hinzufügen.
approve_approval	Schreiben	Eine ausstehende HITL-Genehmigung freigeben.
attach_dossier_tag	Schreiben	Ein Organisationstag an eine Akte anhängen.
create_document_collection	Schreiben	Eine Dokumentsammlung erstellen.
create_invitation	Schreiben	Eine AutoDoc-Einladung per E-Mail oder SMS senden.
create_organization_tag	Schreiben	Ein Organisationstag erstellen.
create_workflow	Schreiben	Einen Workflow erstellen.
delete_document_collection	Destruktiv	Eine Dokumentsammlung löschen (Soft Delete).
delete_invitation	Destruktiv	Eine ausstehende AutoDoc-Einladung stornieren (endgültig löschen).
delete_organization_tag	Destruktiv	Ein Organisationstag löschen.
delete_workflow	Destruktiv	Einen Workflow löschen (Soft Delete).
detach_dossier_tag	Schreiben	Ein Organisationstag von einer Akte lösen.
download_dossier_zip	Lesen	Die Dokumente und Variablen einer Akte in eine ZIP-Datei packen.
duplicate_workflow	Schreiben	Einen Workflow duplizieren.
get_autodoc_dashboard_stats	Lesen	Aggregierte AutoDoc-Dashboard-Statistiken abrufen.
get_document_collection	Lesen	Eine Dokumentsammlung und ihre Anforderungen abrufen.
get_dossier	Lesen	Eine Akte mit Fortschritt und Workflow-Variablen abrufen.
get_dossier_form_fields	Lesen	Formularfeldnamen auflisten, die in Ihren aktiven Workflows verfügbar sind.
get_invitation	Lesen	Eine einzelne AutoDoc-Einladung abrufen.
get_pending_approval_count	Lesen	Die Anzahl ausstehender HITL-Genehmigungen abrufen.
get_workflow	Lesen	Einen einzelnen Workflow abrufen.
list_approvals	Lesen	Menschliche Workflow-Genehmigungen auflisten.
list_document_collections	Lesen	Dokumentsammlungen für Ihre Organisation auflisten.
list_document_types	Lesen	Die Dokumenttypen auflisten, die für Sammlungsanforderungen verfügbar sind.
list_dossier_documents	Lesen	Die in eine Akte hochgeladenen Dokumente auflisten.
list_dossier_notes	Lesen	Die Notizen / den Audit-Zeitverlauf einer Akte auflisten.
list_dossiers	Lesen	AutoDoc-Akten auflisten und filtern.
list_invitation_locales	Lesen	Unterstützte Einladungs-Gebietsschemata auflisten.
list_invitations	Lesen	AutoDoc-Einladungen auflisten.
list_organization_tags	Lesen	Die Akten-Tags Ihrer Organisation auflisten.
list_workflows	Lesen	Workflows für Ihre Organisation auflisten.
reject_approval	Schreiben	Eine ausstehende HITL-Genehmigung ablehnen.
resend_invitation	Schreiben	Eine AutoDoc-Einladung erneut senden.
update_document_collection	Schreiben	Eine Dokumentsammlung und (optional) ihre Anforderungen aktualisieren.
update_dossier	Schreiben	Eine Akte umbenennen.
update_organization_tag	Schreiben	Farbe und/oder Namen eines Organisationstags aktualisieren.
update_workflow	Schreiben	Einen Workflow aktualisieren.

Reasoning- & Betrugs-Agenten (25)

Tool	Zugriff	Beschreibung
create_fraud_agent	Schreiben	Einen Betrugsanalyse-Agenten / Operator erstellen.
create_orchestrator	Schreiben	Einen Orchestrator- (Koordinator-) Agenten erstellen.
create_reasoning_job	Schreiben	Einen ASYNCHRONEN Betrugs-Reasoning-Auftrag für ein Dokument in die Warteschlange stellen.
delete_fraud_agent	Destruktiv	Einen Betrugsanalyse-Agenten / Operator löschen.
delete_orchestrator	Destruktiv	Einen Orchestrator-Agenten löschen.
generate_fraud_agent_prompt	Schreiben	Einen System-Prompt für einen Betrugsanalyse-Agenten mit KI entwerfen.
generate_orchestrator_prompt	Schreiben	Einen System-Prompt für einen Orchestrator mit KI entwerfen.
get_agent	Lesen	Einen einzelnen Agenten (Orchestrator oder Operator) anhand des Tokens abrufen.
get_agent_stats	Lesen	Aggregierte Agentenstatistiken für Ihre Organisation abrufen.
get_reasoning_job	Lesen	Status und vollständige Ergebnisse eines Reasoning-Auftrags abrufen.
list_agent_categories	Lesen	Die verfügbaren Agentenkategorie-Optionen auflisten.
list_agent_ratings	Lesen	Bewertungen und Bewertungszusammenfassung für einen öffentlichen Agenten auflisten.
list_document_content_types	Lesen	Dokumentinhaltsarten auflisten und welche bereits beansprucht sind.
list_fraud_agents	Lesen	Die Betrugsanalyse-Agenten / Operatoren IHRER Organisation auflisten.
list_orchestrators	Lesen	Die Orchestrator-Agenten IHRER Organisation auflisten.
list_public_fraud_agents	Lesen	Öffentliche Betrugsanalyse-Agentenvorlagen aus der globalen Community durchsuchen.
list_public_orchestrators	Lesen	Öffentliche Orchestrator-Vorlagen aus der globalen Community durchsuchen.
list_reasoning_jobs	Lesen	Reasoning-Aufträge mit Filtern und organisationsweiten Statistiken auflisten.
publish_agent	Schreiben	Einen Ihrer Agenten im öffentlichen Community-Marktplatz veröffentlichen.
rate_agent	Schreiben	Einen öffentlichen Agenten mit 1-5 Sternen bewerten.
reorder_orchestrator_agents	Schreiben	Die einem Orchestrator zugewiesenen Betrugsanalyse-Agenten neu anordnen.
test_orchestrator	Schreiben	Einen Orchestrator SYNCHRON gegen ein vorhandenes Dokument ausführen.
unpublish_agent	Schreiben	Einen Ihrer Agenten vom öffentlichen Marktplatz entfernen.
update_fraud_agent	Schreiben	Einen Betrugsanalyse-Agenten / Operator aktualisieren.
update_orchestrator	Schreiben	Einen Orchestrator-Agenten aktualisieren.

Abrechnung (14)

Tool	Zugriff	Beschreibung
cancel_billing_plan	Destruktiv	Kündigung des aktuellen Abonnements planen.
change_billing_plan	Schreiben	Den Abonnementplan der Organisation ändern.
confirm_payment_method	Schreiben	Die bestätigte Karte als Standardzahlungsmethode speichern.
create_setup_intent	Schreiben	Einen Stripe-SetupIntent erstellen, um eine Zahlungsmethode zu erfassen.
download_invoice	Lesen	Eine Rechnung als PDF herunterladen.
get_billing_info	Lesen	Die vollständige Abrechnungsübersicht für die Organisation abrufen.
get_current_usage	Lesen	Die nicht abgerechnete Nutzung des aktuellen Abrechnungszeitraums abrufen.
get_stripe_config	Lesen	Die clientseitige Stripe-Konfiguration abrufen.
list_billing_plans	Lesen	Alle verfügbaren Abonnementpläne mit Preisen und Funktionen auflisten.
list_inference_history	Lesen	Den KI-Inferenz- / Verifizierungsanfrageverlauf der Organisation auflisten.
list_invoices	Lesen	Die Rechnungen der Organisation auflisten, neueste zuerst.
topup_balance	Schreiben	Vorausbezahlte Mittel über die gespeicherte Karte zum Kontoguthaben hinzufügen.
update_company_details	Schreiben	Die Firmen- / Rechnungsdaten der Organisation aktualisieren.
validate_vat_number	Lesen	Eine EU-USt-IdNr. über eine externe Abfrage validieren.

topup_balance ist in US-Dollar, mindestens 10 $, maximal 10.000 $ pro Aufladung.

Benutzer & Konto (7)

Tool	Zugriff	Beschreibung
activate_trial	Schreiben	Eine Zahlungsmethode speichern und die 7-tägige kostenlose Testversion mit 10 $ Guthaben aktivieren.
add_passkey	Schreiben	Mit dem Hinzufügen eines Passkeys zum Konto des authentifizierten Benutzers beginnen: WebAuthn-Erstellungsoptionen abrufen.
delete_passkey	Destruktiv	Einen der Passkeys des authentifizierten Benutzers löschen.
get_current_user	Lesen	Den authentifizierten Benutzer, seine Organisation und schnelle Kontostatistiken abrufen.
list_passkeys	Lesen	Die registrierten Passkeys des authentifizierten Benutzers auflisten.
report_public_data	Schreiben	Falsche Daten im öffentlichen Profil des authentifizierten Benutzers melden.
submit_onboarding_survey	Schreiben	Die Onboarding-Umfrage zur Organisation des aktuellen Benutzers speichern.

Websites (8)

Tool	Zugriff	Beschreibung
create_website	Schreiben	Eine neue Altersverifikations-Website-Konfiguration erstellen.
delete_website	Destruktiv	Eine Altersverifikations-Website-Konfiguration dauerhaft löschen.
get_website	Lesen	Eine Altersverifikations-Website anhand der ID abrufen.
list_countries	Lesen	Alle Länder mit Codes und Attributen auflisten.
list_verifications	Lesen	Den Altersverifikationsverlauf für die Organisation durchsuchen.
list_websites	Lesen	Jede Altersverifikations-Website für die authentifizierte Organisation auflisten.
pause_website	Schreiben	Die Altersverifikation für eine Website pausieren oder fortsetzen.
update_website	Schreiben	Eine vorhandene Altersverifikations-Website-Konfiguration aktualisieren.

Agemin-Prüfungen (3)

Tool	Zugriff	Beschreibung
get_age_verification_status	Lesen	Ein früheres Altersverifizierungsergebnis serverseitig erneut prüfen.
verify_age_with_email	Schreiben	Das Mindestalter einer Person anhand ihrer E-Mail-Adresse schätzen.
verify_age_with_selfie	Schreiben	Das Alter einer Person anhand eines einzelnen Selfie-Bildes schätzen.

Verifizierungssitzungen (16)

Tool	Zugriff	Beschreibung
cancel_session	Destruktiv	Eine Sitzung abbrechen/beenden.
check_email_verification	Lesen	E-Mail-Verifizierung mit dem Code abschließen.
check_phone_verification	Lesen	Telefonverifizierung mit dem SMS-Code abschließen.
complete_liveness	Schreiben	Eine Gesichts-Liveness-Erfassung abschließen.
create_session	Schreiben	Eine neue Identitätsverifizierungssitzung erstellen.
get_session	Lesen	Informationen über eine offene Sitzung anzeigen.
get_session_preflight	Lesen	Den nächsten Verifizierungsschritt für eine Sitzung abrufen.
give_session_consent	Schreiben	Die Einwilligungsentscheidung des Antragstellers erfassen.
send_session_sms	Schreiben	Dem Antragsteller per SMS einen Link zum Fortsetzen auf seinem Telefon senden.
start_email_verification	Schreiben	E-Mail-Verifizierung starten, indem ein Code per E-Mail gesendet wird.
start_liveness	Schreiben	Eine Gesichts-Liveness-Erfassung starten.
start_phone_verification	Schreiben	Telefonverifizierung starten, indem ein Code per SMS gesendet wird.
submit_address_verification	Schreiben	Ein Dokument zum Adressnachweis hochladen.
submit_funds_verification	Schreiben	Ein Dokument zum Finanznachweis hochladen.
update_session	Schreiben	Die Antragstellerdaten einer offenen Sitzung aktualisieren.
upload_session_media	Schreiben	Erfasste Medien zu einer Sitzung hochladen.

API-Schlüssel (3)

Tool	Zugriff	Beschreibung
get_api_key	Lesen	Den VOLLSTÄNDIGEN, maskierten Wert eines vorhandenen API-Schlüssels abrufen.
list_api_keys	Lesen	Alle API-Schlüssel für die authentifizierte Organisation auflisten.
rotate_api_key	Destruktiv	Einen API-Schlüssel für die authentifizierte Organisation rotieren (neu generieren).

list_api_keys gibt maskierte Werte zurück; nur get_api_key gibt das vollständige Geheimnis preis. Halten Sie die Bestätigung daher in gemeinsamen Kontexten für dieses Tool aktiviert. rotate_api_key hält den alten Schlüssel standardmäßig für eine 12-stündige Gnadenfrist gültig; übergeben Sie immediate: true, um ihn sofort zu widerrufen.

NFC (1)

Tool	Zugriff	Beschreibung
submit_nfc_data	Schreiben	NFC-gescannte Identitätsdokumentdaten an eine Verifizierungssitzung übermitteln.

Server & Selbstentdeckung (2)

Tool	Zugriff	Beschreibung
describe_api	Lesen	Die OpenAPI-3.0-Spezifikation der Bynn-REST-API zurückgeben (von /openapi.json).
describe_cli	Lesen	Installations-, Authentifizierungs- und Nutzungsanweisungen für die Bynn-CLI zurückgeben (bynn).

---

Interaktive Widgets

Zwei Tool-Familien geben in Hosts, die MCP-Apps unterstützen (ChatGPT und Claude), interaktive Karten statt rohem JSON zurück:

• Dokumentbetrug (submit_document, get_document): eine Live-Ergebniskarte mit Risikoanzeige, forensischen Signalen, extrahierten Feldern und Risiko-Tags. Ausstehende Analysen pollen sich selbst bis zum Abschluss.
• KI-Bildprüfung (detect_ai_generated_image): Ergebniskarte mit KI-Wahrscheinlichkeit und einer Generator-Aufschlüsselung. Wenn kein Bild bereitgestellt wurde, rendert die Karte einen Drag-and-Drop-Uploader, und die abgelegte Datei geht direkt an den Detektor, ohne in den Chat-Kontext zu gelangen.

Andere MCP-Clients erhalten dieselben Daten einfach als strukturiertes JSON.

---

Beispiel-Workflow

Eine vollständige KYC-Sitzung, konversationell gesteuert:

1. "Create a verification session for applicant #4471 with my standard KYC level."
   → create_session returns {session_id, dossier_id, url, qr_base64_png, websocket_url}
2. Send the returned `url` to the applicant (or show the QR code).
3. "What's the next step for this session?"
   → get_session_preflight (after give_session_consent) walks each remaining step
4. "Show the session status."
   → get_session, repeated until the flow completes

Das asynchrone Muster ist überall gleich: Erstellungstools geben eine ID zurück, get_*-Tools pollen sie. Für Dokumentbetrug: submit_document → get_document bis status: "analyzed"; für Reasoning-Jobs: create_reasoning_job → get_reasoning_job.

---

Bynn-CLI: Mit lokalen Dateien arbeiten

Der gehostete MCP-Server kann keine Dateien auf Ihrem Rechner lesen. Die Bynn-CLI kann das. Agents, die lokal laufen (Claude Code, Cursor, ein Terminal), können lokale Dateien direkt analysieren:

bynn submit ./bank-statement.pdf -o json      # full document-fraud analysis, auto-polls
bynn ai-generated ./profile-photo.png -o json # AI-generated-image check

Installation (macOS/Linux):

brew tap Bynn-Intelligence/bynn
brew install --cask bynn

Installation (Windows):

scoop bucket add bynn https://github.com/Bynn-Intelligence/scoop-bynn
scoop install bynn

Direkte Downloads (plus .deb/.rpm und Prüfsummen) finden Sie auf der Releases-Seite.

Einmalig authentifizieren (bynn auth login speichert den Schlüssel in Ihrem OS-Schlüsselbund) oder nicht-interaktiv mit BYNN_API_KEY, --token oder bynn auth login --with-token. Sandbox-Schlüssel (private_sandbox_...) werden automatisch erkannt.

Agentenfreundlich gestaltet: -o json für strukturierte Ausgabe, --jq zum Filtern, --dry-run zum Vorschauen von Anfragen, --poll für asynchrone Ergebnisse und ein sauberer Ausgabevertrag (stdout = Daten, stderr = Fortschritt). Der Befehlsbaum wird aus der Live-Bynn-OpenAPI-Spezifikation generiert, und bynn api <METHOD> <PATH> ist ein roher, authentifizierter Passthrough zu jedem Endpunkt. Die CLI deckt Sitzungen, Altersverifizierung, AutoDoc-Einladungen, Dokumente, Moderation, NFC und Gesicht ab; für Abrechnung, API-Schlüssel, Dossiers, Orchestratoren und Websites verwenden Sie diesen MCP-Server.

Für Agents: Rufen Sie das describe_cli-Tool auf diesem Server auf, um diesen gesamten Leitfaden in maschinenlesbarer Form zu erhalten.

---

Selbstentdeckung für Agents

Der Server dokumentiert sich selbst. Wenn Sie ein LLM sind, das mit ihm verbunden ist:

• describe_api gibt die vollständige Bynn-OpenAPI-3.0-Spezifikation zurück: jeden Endpunkt, Parameter und jedes Schema, einschließlich derer, die nicht als MCP-Tools gekapselt sind. Keine Authentifizierung erforderlich.
• describe_cli gibt einen strukturierten Leitfaden zur Installation, Authentifizierung und Ausführung der bynn-CLI lokal zurück, für die Arbeit mit lokalen Dateien. Keine Authentifizierung erforderlich.
• file://server/status (MCP-Ressource) gibt die Live-Tool-Liste und den Serverstatus zurück.

Diese werden auch in den initialize-Anweisungen des Servers angekündigt, sodass Sie diese README nicht benötigen, um sie zu finden.

---

Erweitert

Annotationen und Antwortvertrag

Jedes Tool trägt MCP-ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), konsistent nach Verb angewendet: get_*/list_*/search_*/describe_*/download_*/validate_* sind schreibgeschützt; delete_*/cancel_*/rotate_api_key sind destruktiv. Fehler werden als strukturierte {error: true, error_type, message}-Payloads zurückgegeben und nicht als Protokollfehler, sodass Agents sie lesen und darauf reagieren können.

Fehlerbehebung

Symptom	Lösung
404 / Verbindung schlägt sofort fehl	Sie haben /mcp an die URL angehängt. Der Endpunkt ist die Wurzel: https://mcp.bynn.com
authentication_error / authentication_required	Holen Sie sich ein Token unter dashboard.bynn.com/authenticate und setzen Sie es als Authorization-Header. Wiederholen Sie nicht blind.
Ein Tool gibt 401 mit einer gültigen Verbindung zurück	Falscher Anmeldedatentyp für diese Tool-Gruppe; siehe die Auth-Tabelle. API-Schlüssel und Abrechnung benötigen ein Dashboard-Token, keinen rohen private_-Schlüssel.
Bildtool meldet, dass kein Bild bereitgestellt wurde	Die erscheinende Karte akzeptiert Drag-and-Drop; ziehen Sie das Bild hinein. Oder übergeben Sie eine öffentliche image_url.
Dokument bleibt in pending hängen	Die Analyse ist asynchron; pollen Sie get_document, bis status analyzed ist. Pollen Sie nicht häufiger als alle paar Sekunden.
OAuth-Connector funktioniert nicht mehr	Trennen Sie den Connector und verbinden Sie ihn erneut, um den Anmeldevorgang erneut auszuführen.

Support

Probleme und Fragen: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

MIT-lizenziert.