simsima-connectivity — servidor MCP

Sitio web: simsima.io · Endpoint: POST https://mcp.simsima.io/mcp (Streamable HTTP) · Registro: io.github.Willyfab/simsima-connectivity

Servidor MCP público que expone el catálogo de eSIM de viaje de Simsima a agentes de IA. Endpoint: POST https://mcp.simsima.io/mcp (Streamable HTTP). Salud: GET /health.

Herramientas

• list_destinations — países/regiones cubiertos, con precio mínimo + URL del producto.

• search_plans — planes para un destino, con filtros opcionales de precio/datos/validez.

• get_plan — un solo plan por sku.

• recommend_plan — mejor(es) plan(es) para un viaje (duración + uso ligero/medio/intenso).

• create_checkout_link — una URL de producto de Simsima con atribución de agente (source/utm_*), con el plan ya preseleccionado.

• check_coverage — ¿cubre este destino este país? Toma un nombre de país o un código ISO, y devuelve el plan de país independiente tanto si la respuesta es sí como no.

• get_destination_info — cobertura, operadores móviles, disponibilidad de recarga y precio de entrada para un destino.

Solo lectura + enlace con atribución. Sin pagos, sin datos de pedidos, sin autenticación.

Related MCP server: a2a-travel-mcp-servers

Fuente de datos

Lee el feed web público ${SIMSIMA_FEED_BASE}/{locale}/agent/catalog (en caché ~15 min). Las URL de producto provienen directamente del feed → siempre válidas (cero 404). Sin base de datos, sin llamadas de backend.

Ese feed se construye a partir del catálogo vendible de Simsima — la misma fuente que leen el sitio web y el feed de Google Shopping. Así que lo que este servidor responde es lo que el sitio realmente vende: un plan por (destino, datos, duración), planes ilimitados resueltos mediante la cascada de uso justo del sitio, y el precio mínimo de pago ya aplicado.

La cobertura y los operadores móviles viajan en el bloque destinations del feed, una vez por destino en lugar de en cada plan (solo la zona de Europa lleva ~40 códigos de país). Los operadores se listan solo para destinos de un solo país: en una zona, las redes de cuarenta países mezcladas no dirían nada útil.

Entorno

• SIMSIMA_FEED_BASE (por defecto https://simsima.io)

• PORT (por defecto 8080)

• RATE_LIMIT_RPM (por defecto 60)

• POSTHOG_KEY (opcional) — clave de API del proyecto PostHog. Cuando se establece, el servidor emite un evento mcp_tool_call por cada llamada de herramienta, con resultCount, feedStale y un failureReason con nombre cuando una llamada vuelve vacía, además de un evento dedicado mcp_checkout_link cuando se entrega un enlace de pago. Ausente → telemetría desactivada (no-op).

• POSTHOG_HOST (opcional, por defecto https://eu.i.posthog.com) — host de ingesta de PostHog (coincide con la aplicación web).

Desarrollo local

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

Conectar desde Claude (validación privada — Fase 1a)

Añade un conector personalizado que apunte a https://mcp.simsima.io/mcp, y luego prueba: "Recomiéndame un eSIM para 7 días en Japón con uso medio."

Despliegue

Aplicación Coolify, contexto de compilación Docker = mcp/, subdominio mcp.simsima.io. Despliegue automático al hacer push a main. Establece las variables de entorno SIMSIMA_FEED_BASE, PORT, RATE_LIMIT_RPM.

Publicación en el Registro MCP (Fase 1b)

Los metadatos viven en server.json (espacio de nombres io.github.Willyfab/simsima-connectivity, remoto streamable-http en https://mcp.simsima.io/mcp). El descubrimiento también se insinúa desde web/public/llms.txt + llms-full.txt.

Para publicar (necesita la CLI mcp-publisher + autenticación de GitHub como propietario del repositorio):

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

• Incrementa version en server.json en cada cambio significativo y vuelve a ejecutar publish.

• Para usar un espacio de nombres de marca com.simsima/connectivity en su lugar, verifica la propiedad del dominio de simsima.io mediante un registro DNS TXT, luego actualiza name en server.json (la URL remota mcp.simsima.io ya está en el dominio verificado).