Letisim retail MCP

Öffentliche, redirect-first MCP-Oberfläche für die Entdeckung von Consumer-eSIMs und die Übergabe an den Checkout.

Der Server akzeptiert bewusst keine E-Mail- oder Zahlungsdaten. create_checkout speichert nur einen inerten, PII-freien AgentCheckout; der Käufer muss die zurückgegebene First-Party-Letisim-URL öffnen. Der bestehende Web-Checkout erstellt dann ein neues Angebot, erfasst E-Mail/Rechtsgrundlage, erstellt die Bestellung/Zahlung und übergibt die Zahlungsdaten direkt an den PSP.

Lokale Ausführung

npm run build -w @letisim/retail-mcp
# Start the API separately with RETAIL_MCP_ENABLED=1 in a non-production test environment.
LETISIM_API_BASE_URL=http://127.0.0.1:3200 npm run start:http -w @letisim/retail-mcp

Der Streamable-HTTP-Endpunkt ist http://127.0.0.1:3210/retail; start:stdio stellt dieselbe Tool-Factory einem lokalen MCP-Host bereit. Ein Nicht-Loopback-Bind ist fail-closed, sofern nicht RETAIL_MCP_ALLOWED_HOSTS gesetzt ist. Dieses Paket ist privat/nur für Tests, bis die rechtlichen, steuerlichen, Beleg-, Missbrauchs-, Client-Matrix- und kontrollierten Live-Gates im ExecPlan geschlossen sind. Die API-Routen sind fail-closed, sofern nicht RETAIL_MCP_ENABLED=1 gesetzt ist; der Schlüssel ist absichtlich nicht in der generischen Produktions-Env-Writer-Allowlist enthalten.

Related MCP server: mcp-esim

Partner-Attribution

Eine Installation kann einem Affiliate-Partner mit einer einzigen Umgebungsvariable zugeordnet werden:

LETISIM_MCP_ATTRIBUTION=promo:TRAVELPRO   # or ref:<campaign-slug>

Käufe, die von dieser Installation gestartet werden, tragen den Promo-Code des Partners in die First-Party-Checkout-URL, und die bestehenden Affiliate-Regeln entscheiden über die Provision. Der Handle ist bewusst kein Tool-Argument: Ein Agent, der eine nicht vertrauenswürdige Seite gelesen hat, darf nicht in der Lage sein, die Provision einer anderen Person umzuleiten. Ein fehlerhafter, unbekannter oder widerrufener Handle führt zu einem Checkout ohne Attribution und schlägt nie fehl. Fragen Sie nach Ihrem Handle im Letisim-Affiliate-Bereich unter https://partner.letisim.com.

Installation in Claude Code

claude plugin marketplace add skorik94-glitch/letisim-mcp
claude plugin install letisim@letisim

Das Plugin führt die gebündelte dist/stdio.js aus, benötigt also kein npm-Paket und keinen Build-Schritt. Exportieren Sie LETISIM_MCP_ATTRIBUTION, bevor Sie Claude Code starten, wenn Sie Affiliate sind.

Aktuelle Fähigkeiten

Plansuche, Zielabdeckung und Preise sind live gegen den Produktionskatalog. Angebotserstellung und Checkout-Übergabe antworten mit 404, bis Letisim das Agent-Commerce-Gate öffnet – das ist ein bewusster serverseitiger Schalter, kein Client-Fehler.

Distribution

Registrierungsmetadaten befinden sich in server.json und werden von test/distribution.test.ts mit package.json synchron gehalten. Das öffentliche Repository https://github.com/skorik94-glitch/letisim-mcp wird aus dem Letisim-Monorepo von scripts/sync-retail-mcp-public.mjs generiert: Bearbeiten Sie die Quelle upstream, niemals im Spiegel.