{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"roaming-esim-catalog","title":"Roaming eSIM Catalog","version":"1.0.0"},"description":"Read-only access to current Roaming eSIM destinations and package availability. Checkout remains a user-controlled browser flow.","iconUrl":"https://www.roamingesim.com/assets/images/logo.png","documentationUrl":"https://www.roamingesim.com/api-docs#mcp","transport":{"type":"streamable-http","endpoint":"https://www.roamingesim.com/mcp"},"capabilities":{"tools":{"listChanged":false}},"instructions":"Search destinations first, then use the returned location value to request packages. Treat availability and prices as live data and direct the user to the returned product URL to continue.","tools":[{"name":"search_esim_destinations","title":"Search eSIM destinations","description":"Search current Roaming eSIM country and regional destinations. Results include the live location code, starting price, package count, and product URL.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":80,"description":"Optional country, region, or location-code search text. Leave empty to browse destinations."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Maximum number of destinations to return."}},"additionalProperties":false},"outputSchema":{"type":"object","required":["query","total","returned","destinations"],"properties":{"query":{"type":"string"},"total":{"type":"integer"},"returned":{"type":"integer"},"destinations":{"type":"array","items":{"type":"object","required":["name","location","coverageType","currency","productUrl"],"properties":{"name":{"type":"string"},"location":{"type":"string"},"coverageType":{"type":"string","enum":["country","regional"]},"startingPrice":{"type":["number","null"]},"currency":{"type":"string"},"packageCount":{"type":["integer","null"]},"productUrl":{"type":"string","format":"uri"}},"additionalProperties":false}}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_esim_packages","title":"Get eSIM packages","description":"Get the current packages for an exact location code returned by search_esim_destinations. Package availability and prices come from the live catalog.","inputSchema":{"type":"object","properties":{"location":{"type":"string","minLength":2,"maxLength":512,"description":"Exact location value returned by search_esim_destinations, such as PT or a comma-separated regional code list."}},"required":["location"],"additionalProperties":false},"outputSchema":{"type":"object","required":["ok","location","packageCount","packages","pricingNote","checkedAt"],"properties":{"ok":{"const":true},"location":{"type":"string"},"packageCount":{"type":"integer"},"packages":{"type":"array","items":{"type":"object","required":["publicPlanId","name","slug","location","dataType","dataAmountBytes","validity","networkSpeed","fairUsePolicy","retailPrice","currency","priceBasis","supportsTopUp","coverage","productUrl"],"properties":{"publicPlanId":{"type":"string","pattern":"^RES[a-f0-9]{32}$"},"name":{"type":"string"},"slug":{"type":["string","null"]},"location":{"type":"string"},"dataType":{"type":"string","enum":["daily","fixed"]},"dataAmountBytes":{"type":["integer","null"]},"validity":{"type":"object"},"networkSpeed":{"type":["string","null"]},"fairUsePolicy":{"type":["string","null"]},"retailPrice":{"type":["number","null"]},"currency":{"type":"string"},"priceBasis":{"type":"string","enum":["per_day","plan"]},"supportsTopUp":{"type":"boolean"},"coverage":{"type":"array"},"productUrl":{"type":"string","format":"uri"}},"additionalProperties":false}},"pricingNote":{"type":"string"},"checkedAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[],"prompts":[]}