simsima-connectivity — MCP-Server

Website: simsima.io · Endpunkt: POST https://mcp.simsima.io/mcp (Streamable HTTP) · Registry: io.github.Willyfab/simsima-connectivity

Öffentlicher MCP-Server, der den Reise-eSIM-Katalog von Simsima für KI-Agenten bereitstellt. Endpunkt: POST https://mcp.simsima.io/mcp (Streamable HTTP). Health: GET /health.

Tools

• list_destinations — abgedeckte Länder/Regionen, mit Mindestpreis + Produkt-URL.

• search_plans — Pläne für ein Ziel, mit optionalen Preis-/Daten-/Gültigkeitsfiltern.

• get_plan — ein einzelner Plan per SKU.

• recommend_plan — beste Pläne für eine Reise (Länge + leichte/mittlere/starke Nutzung).

• create_checkout_link — eine Simsima-Produkt-URL mit Agenten-Attribution (source/utm_*), der Plan ist bereits vorausgewählt.

• check_coverage — deckt dieses Ziel dieses Land ab? Nimmt einen Ländernamen oder einen ISO-Code und liefert den eigenständigen Länderplan zurück, ob die Antwort ja oder nein lautet.

• get_destination_info — Abdeckung, Mobilfunkbetreiber, Aufladungsmöglichkeit und Einstiegspreis für ein Ziel.

Nur Lesen + attribuierter Link. Keine Zahlung, keine Bestelldaten, keine Authentifizierung.

Related MCP server: gliana-mcp-remote

Datenquelle

Liest den öffentlichen Web-Feed ${SIMSIMA_FEED_BASE}/{locale}/agent/catalog (gecacht ~15 Min.). Produkt-URLs kommen direkt aus dem Feed → immer gültig (null 404). Keine Datenbank, keine Backend-Aufrufe.

Dieser Feed wird aus Simsimas verkaufbarem Katalog aufgebaut — dieselbe Quelle, aus der auch die Website und der Google-Shopping-Feed lesen. Was dieser Server also antwortet, ist das, was die Website tatsächlich verkauft: ein Plan pro (Ziel, Daten, Dauer), unbegrenzte Pläne aufgelöst über die Fair-Use-Kaskade der Website, und die Mindestpreisgrenze beim Checkout ist bereits angewendet.

Abdeckung und Mobilfunkbetreiber befinden sich im destinations-Block des Feeds, einmal pro Ziel anstatt auf jedem Plan (allein die Europa-Zone trägt ~40 Länderkennungen). Betreiber werden nur für Einzelland-Ziele gelistet: In einer Zone würden die Netze von vierzig Ländern vermischt nichts Nützliches aussagen.

Env

• SIMSIMA_FEED_BASE (Standard https://simsima.io)

• PORT (Standard 8080)

• RATE_LIMIT_RPM (Standard 60)

• POSTHOG_KEY (optional) — PostHog-Projekt-API-Schlüssel. Wenn gesetzt, sendet der Server ein mcp_tool_call-Ereignis pro Tool-Aufruf, das resultCount, feedStale und einen benannten failureReason trägt, wenn ein Aufruf leer zurückkommt, sowie ein dediziertes mcp_checkout_link-Ereignis, wenn ein Checkout-Link ausgegeben wird. Fehlt → Telemetrie deaktiviert (no-op).

• POSTHOG_HOST (optional, Standard https://eu.i.posthog.com) — PostHog-Ingestion-Host (passend zur Web-App).

Lokale Entwicklung

cd mcp
npm install
npm test          # jest (42 tests)
npm run dev       # ts-node-dev on :8080
curl localhost:8080/health

Verbindung über Claude (private Validierung — Phase 1a)

Fügen Sie einen benutzerdefinierten Connector hinzu, der auf https://mcp.simsima.io/mcp zeigt, und versuchen Sie dann: „Empfiehl mir eine eSIM für 7 Tage in Japan bei mittlerer Nutzung."

Deployment

Coolify-App, Docker-Build-Kontext = mcp/, Subdomain mcp.simsima.io. Auto-Deploy bei Push auf main. Setzen Sie die Umgebungsvariablen SIMSIMA_FEED_BASE, PORT, RATE_LIMIT_RPM.

Veröffentlichung im MCP-Registry (Phase 1b)

Metadaten liegen in server.json (Namespace io.github.Willyfab/simsima-connectivity, remote streamable-http unter https://mcp.simsima.io/mcp). Die Auffindbarkeit wird auch über web/public/llms.txt + llms-full.txt angedeutet.

Zum Veröffentlichen (benötigt die mcp-publisher-CLI + GitHub-Auth als Repository-Besitzer):

cd mcp
# install: see github.com/modelcontextprotocol/registry (release binary or `go install`)
mcp-publisher login github     # OIDC auth for the io.github.Willyfab/* namespace
mcp-publisher publish          # validates server.json and publishes

• Erhöhen Sie version in server.json bei jeder bedeutsamen Änderung und führen Sie publish erneut aus.

• Um stattdessen einen gebrandeten Namespace com.simsima/connectivity zu verwenden, verifizieren Sie den Domain-Besitz von simsima.io über einen DNS-TXT-Eintrag und aktualisieren Sie dann name in server.json (die Remote-URL mcp.simsima.io liegt bereits auf der verifizierten Domain).