Model Context Protocol

Fotoechtheit aus jedem KI-Agenten prüfen

Lumethic stellt einen Remote-MCP-Server bereit, damit KI-Agenten direkt in ihrer Toolchain prüfen können, ob ein Foto eine echte, unveränderte Kameraaufnahme ist. Kein SDK nötig: Verbinden Sie Ihren Client mit dem Endpunkt und rufen Sie die Tools auf.

Endpunkt

Verbindung über Streamable HTTP

Der Server spricht das Model Context Protocol über einen Streamable-HTTP-Endpunkt. Er ist zustandslos, eine Sitzungsbindung ist daher nicht erforderlich.

Produktion

https://api.lumethic.com/mcp

Transport: Streamable HTTP

Authentifizierung

API-Schlüssel oder anonymer Tarif ohne Schlüssel

Erstellen Sie einmalig einen API-Schlüssel und senden Sie ihn bei jeder Anfrage mit. Sie können den Server zum Ausprobieren auch ganz ohne Schlüssel im ratenbegrenzten anonymen Tarif aufrufen.

Authorization-Header

Senden Sie Ihren Schlüssel als Bearer-Token: Authorization: Bearer lk_… — genau das sendet der mcp_servers-Connector von Claude über sein Feld authorization_token.

X-API-Key-Header

Alternativ übergeben Sie den Schlüssel in einem X-API-Key: lk_… Header.

Anonymer Tarif ohne Schlüssel

Rufen Sie den Server ohne Zugangsdaten auf, um ihn zu testen. Dieser Tarif ist ratenbegrenzt und zum Ausprobieren vor der Registrierung gedacht.

API-Schlüssel erstellen

Schnellstart

Client verbinden

Fügen Sie den Server zu Ihrem bevorzugten MCP-Client hinzu. Ersetzen Sie lk_… durch Ihren eigenen API-Schlüssel.

Claude Code

claude mcp add --transport http lumethic \
  https://api.lumethic.com/mcp \
  --header "X-API-Key: lk_..."

Claude Messages API

"mcp_servers": [
  {
    "type": "url",
    "name": "lumethic",
    "url": "https://api.lumethic.com/mcp",
    "authorization_token": "lk_..."
  }
]

Python (MCP SDK)

from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://api.lumethic.com/mcp",
    headers={"X-API-Key": "lk_..."},
) as (read, write, _):
    ...

Toolset

Was Agenten aufrufen können

Nach dem Verbinden stehen Agenten die folgenden Tools zur Verfügung. Die Verifizierungs-Tools funktionieren im anonymen Tarif; Konto- und Marktplatz-Tools erfordern einen API-Schlüssel.

verify_photoPrüft ein Foto anhand einer RAW-Datei und ihres JPEG-Exports (Inline-Base64 für kleine Dateien).

create_verification_uploadLiefert vorsignierte S3-URLs für große RAW-Dateien; laden Sie die Bytes per PUT hoch und übergeben Sie die zurückgegebenen Object-Keys an verify_photo.

get_verificationRuft eine Verifizierung per ID ab; fragen Sie ab, bis der Status completed ist, um das Echtheitsergebnis zu lesen.

list_verificationsListet die Verifizierungen Ihres Kontos auf. Erfordert einen API-Schlüssel.

get_account_usageMeldet Ihren Tarif sowie genutzte und verbleibende Verifizierungen. Erfordert einen API-Schlüssel.

share_verificationErstellt einen öffentlichen Freigabe-Link für eine Verifizierung.

get_verification_shareLiest den aktuellen öffentlichen Freigabestatus einer Verifizierung.

unshare_verificationWiderruft den öffentlichen Freigabe-Link einer Verifizierung.

get_listingLiest ein einzelnes Marktplatz-Angebot.

list_my_listingsListet Ihre eigenen Marktplatz-Angebote auf.

Ressource

lumethic://pricing — beschreibt die verfügbaren Tarife und ihre Limits.

Ablauf

Vom Upload zum Urteil

Eine typische Echtheitsprüfung läuft in vier Schritten ab.

Verbinden

Verbinden Sie Ihren MCP-Client mit dem Endpunkt und authentifizieren Sie sich mit einem API-Schlüssel (oder nutzen Sie den anonymen Tarif).

Hochladen

Rufen Sie verify_photo mit der RAW-Datei und ihrem JPEG-Export auf. Für große RAW-Dateien rufen Sie zuerst create_verification_upload auf, laden die Bytes per PUT zu den vorsignierten URLs hoch und übergeben die zurückgegebenen Object-Keys.

Abfragen

Rufen Sie get_verification per ID auf, bis der Status completed ist. Die Verarbeitung dauert in der Regel einige Minuten.

Ergebnis lesen

Lesen Sie das Echtheitsurteil und die Konfidenz. Ein Bestehen ist ein starker Beleg dafür, dass das Foto eine echte, unveränderte Aufnahme ist.

Fehlerbehandlung

Maschinenlesbare Fehlercodes

Tool-Fehler kommen mit maschinenlesbaren Codes zurück, damit ein Agent reagieren und die Nutzerin oder den Nutzer bei Bedarf zur Registrierung oder zum Upgrade auffordern kann.

QUOTA_EXCEEDEDDas Verifizierungskontingent des Tarifs ist aufgebraucht. Fordern Sie zur Registrierung oder zum Upgrade auf.

INVALID_CREDENTIALSDer API-Schlüssel fehlt oder ist ungültig. Prüfen Sie den Authorization- oder X-API-Key-Header.

RATE_LIMIT_EXCEEDEDZu viele Anfragen im anonymen Tarif ohne Schlüssel. Fügen Sie einen API-Schlüssel hinzu oder drosseln Sie die Anfragen.

Bereit, einen Agenten zu verbinden?

Erstellen Sie einen API-Schlüssel in Ihrem Dashboard und verbinden Sie dann Ihren MCP-Client mit dem Endpunkt. Lieber pures HTTP? Die REST-API stellt dieselbe Verifizierungs-Engine bereit.

API-Schlüssel erstellen REST-API-Doku