Letisim retail MCP

Публичная MCP-поверхность с приоритетом перенаправления (redirect-first) для поиска потребительских eSIM и передачи на оформление заказа.

Сервер намеренно не принимает email и платёжные реквизиты. create_checkout сохраняет только инертную, не содержащую PII сущность AgentCheckout; покупатель должен открыть возвращённый фирменный URL Letisim. Существующий веб-чекаут затем повторно формирует предложение, собирает email и юридически значимые действия, создаёт Order/Payment и передаёт платёжные данные напрямую PSP.

Локальный запуск

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

Конечная точка Streamable HTTP — http://127.0.0.1:3210/retail; start:stdio предоставляет ту же фабрику инструментов локальному MCP-хосту. Привязка не к loopback-адресу закрыта по умолчанию (fail-closed), если не задан RETAIL_MCP_ALLOWED_HOSTS. Этот пакет является приватным и используется только для тестирования, пока не закрыты проверки legal, tax, receipt, abuse, client-matrix и controlled-live в ExecPlan. Маршруты API закрыты по умолчанию, если только не задан RETAIL_MCP_ENABLED=1; этот ключ намеренно не входит в общий список разрешённых к записи переменных production-окружения.

Related MCP server: mcp-esim

Партнёрская атрибуция

Установка может быть привязана к аффилированному партнёру с помощью одной переменной окружения:

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

Покупки, начатые этой установкой, переносят промокод партнёра в фирменный URL чекаута, а существующие правила аффилированной программы определяют комиссию. Handle намеренно не является аргументом инструмента: агент, прочитавший недоверенную страницу, не должен иметь возможности перенаправить чужую комиссию. Некорректный, неизвестный или отозванный handle деградирует до чекаута без атрибуции и никогда не приводит к сбою покупки. Запросите свой handle в аффилированном кабинете Letisim по адресу https://partner.letisim.com.

Установка в Claude Code

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

Плагин запускает встроенный dist/stdio.js, поэтому ему не нужен npm-пакет и не нужен шаг сборки. Экспортируйте LETISIM_MCP_ATTRIBUTION перед запуском Claude Code, если вы аффилированный партнёр.

Текущие возможности

Поиск планов, покрытие направлений и цены работают в реальном времени на основе production-каталога. Квотирование и передача на чекаут возвращают 404, пока Letisim не откроет шлюз агентной коммерции — это намеренный серверный переключатель, а не ошибка клиента.

Распространение

Метаданные реестра находятся в server.json и синхронизируются с package.json с помощью test/distribution.test.ts. Публичный репозиторий https://github.com/skorik94-glitch/letisim-mcp создаётся из монорепозитория Letisim скриптом scripts/sync-retail-mcp-public.mjs: вносите изменения в исходный код в upstream, но никогда — в зеркало.