开一家旅行社？使用我们的实时 eSIM 比较数据。

Compare a traveller’s trip using our read-only JSON API or remote MCP server. Both use the same catalogue, coupon conditions and ranking formulas as RoamSonar. No account is required for light use.

Connect with MCP

Add https://roamsonar.com/mcp as a remote Streamable HTTP server in a client that supports custom MCP connections. Select no authentication. There is no API key to paste into a prompt.

The tools are list_destinations 和 search_esim_plans. Try asking: “Compare eSIMs for 10 days in Japan, with normal data use. Show the cheapest options and any coupon restrictions.”

{
  "name": "search_esim_plans",
  "arguments": {
    "country": "JP",
    "days": 10,
    "need": "normal",
    "sort": "cheapest"
  }
}

MCP returns up to 20 plans in the requested order. It does not book, pay, run code, browse arbitrary URLs or expose provider feed credentials. No AI-model call is made by this server. Client availability and setup vary; a compatible remote MCP client is required.

Transport: JSON-RPC POST; protocol versions 2025-11-25, 2025-06-18 and 2025-03-26. Send Accept: application/json, text/event-stream 和 Content-Type: application/json. After initialization, send the negotiated MCP-Protocol-Version. No persistent SSE stream or session is created; GET returns 405. Browser-origin calls are same-origin only; use a server-side MCP connection.

Use the JSON API

OpenAPI 3.1 →
获取 https://roamsonar.com/api/v1/plans?country=JP&days=10&need=normal

One response includes up to 20 results in each of Recommended, Cheapest and Fastest. /api/v1/countries supplies destination codes. Prices are USD and must keep their returned eligibility and freshness context.

参数价值观
国家ISO-2，例如 JP
天1–90
需要轻型、普通、重型、无限制
includeOptional: variants, for a bounded duration comparison. The same result limits apply; this is not an export.

Light-use limits

RequestPer network addressShared service budget
Plan comparisons, REST + MCP combined12/minute · 120/UTC day2,000/UTC day
Destination lists and health checks30/minute · 300/UTC day10,000/UTC day
Uncached plan comparisonsIncluded in your plan quota250/UTC day; cached matches remain available

Limits are shared across clients, routes and cached requests. IPv4 addresses and IPv6 /64 networks identify anonymous callers; offices, mobile networks and hosted assistants may share an allowance. Reconnecting, changing tools or changing a client name does not create a new allowance. Additional edge burst protection applies.

A limit returns 429 with Retry-After in seconds. Quota headers X-RateLimit-Limit, X-RateLimit-Remaining 和 X-RateLimit-Reset describe the applicable window (reset is Unix seconds). Wait; do not retry in a loop. Protection or data failures return 503. Neither error is cached.

Cache plan responses for 15 minutes and destination lists for one hour. Health snapshots may be up to five minutes old and include checked_at; uncached health checks have a separate 500/day service budget. This keeps monitoring from consuming the plan-query budget.

Fair use and attribution

Use this service for individual trip research, light travel-assistant integrations and journalistic comparisons. Attribute visible use as 数据由 RoamSonar 提供 and keep returned /去/ URLs intact. Do not remove coupon conditions or imply that an estimated price is guaranteed at checkout.

Bulk scraping, catalogue mirroring, systematic country/date enumeration, quota evasion and raw-feed resale are not permitted. These rules apply equally to browsers, MCP clients and automated scraping tools. A client’s brand is not proof of human use.

Contact us for a planned research or higher-volume integration before sustained use. Public access is capacity-limited, not an unlimited data feed. See our privacy policy for short-lived abuse-prevention counters.

Ask AI