Letisim retail MCP

공개형, 리디렉트 우선(redirect-first) MCP 서피스로, 소비자 대상 eSIM 검색과 체크아웃 연결(handoff)을 담당합니다.

이 서버는 의도적으로 이메일이나 결제 자격 증명을 받지 않습니다. create_checkout은 비활성이고 개인식별정보(PII)가 없는 AgentCheckout만 저장하며, 구매자는 반환된 first-party Letisim URL을 직접 열어야 합니다. 이후 기존 웹 체크아웃이 재견적을 수행하고 이메일/법적 동의를 수집한 다음 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 호스트에 노출합니다. 루프백이 아닌 바인딩은 RETAIL_MCP_ALLOWED_HOSTS가 설정되지 않는 한 fail-closed(기본 차단)입니다. 이 패키지는 ExecPlan에 있는 법률, 세금, 영수증, 남용, 클라이언트 매트릭스 및 통제된 라이브 운영 게이트가 모두 닫힐 때까지 비공개/테스트 전용입니다. API 라우트는 RETAIL_MCP_ENABLED=1이 아니면 fail-closed이며, 해당 키는 의도적으로 일반 프로덕션 환경 변수 허용 목록에 포함되어 있지 않습니다.

Related MCP server: mcp-esim

파트너 귀속

설치본 하나를 환경 변수 하나로 제휴 파트너에게 귀속시킬 수 있습니다:

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

해당 설치본에서 시작된 구매는 파트너의 프로모션 코드를 기존 체크아웃 URL에 담아 전달하며, 수수료는 기존 제휴 규칙에 따라 결정됩니다. 핸들은 의도적으로 도구 인자가 아닙니다. 신뢰할 수 없는 페이지를 읽은 에이전트가 다른 사람의 수수료를 돌릴 수 없게 하기 위해서입니다. 형식이 잘못되었거나, 알 수 없거나, 해지된 핸들은 귀속 없는 체크아웃으로 처리되며 구매를 실패시키지 않습니다. 핸들을 얻으려면 https://partner.letisim.com의 Letisim 제휴 대시보드에서 요청하세요.

Claude Code에 설치

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

이 플러그인은 번들된 dist/stdio.js를 실행하므로 npm 패키지나 빌드 단계가 필요 없습니다. 제휴 파트너라면 Claude Code를 시작하기 전에 LETISIM_MCP_ATTRIBUTION을 export 하세요.

현재 기능

요금제 검색, 목적지 커버리지와 가격은 프로덕션 카탈로그를 기준으로 실시간 제공됩니다. 견적과 체크아웃 핸드오프는 Letisim이 에이전트 커머스(agent commerce) 게이트를 열 때까지 404를 반환합니다. 이는 의도적인 서버 측 스위치이며 클라이언트 버그가 아닙니다.

배포

레지스트리 메타데이터는 server.json에 있으며, test/distribution.test.ts가 package.json과 동기화 상태를 유지합니다. 공개 리포지토리 https://github.com/skorik94-glitch/letisim-mcp는 Letisim 모노레포로부터 scripts/sync-retail-mcp-public.mjs에 의해 생성됩니다. 소스는 업스트림에서 수정하고, 미러에서는 절대 수정하지 마세요.