Skip to main content
Glama

eSIM-Global.VIP eSIM Catalog

Get plan details

get_plan_details
Read-onlyIdempotent

Full facts for one eSIM-Global.VIP plan by product id: coverage with networks per country, data and speed rules, activation and validity rules, hotspot / APN / registration facts, top-up, refund rule, price with basis, reviews and link — quoted in the customer's bucket or currency when given.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bucketNoOptional language-region bucket the customer shops in, e.g. "en-gb", "de-de". Wins over language; prices and links are quoted in it.
currencyNoOptional ISO 4217 code. Every price in the result is quoted in it.
languageNoISO language of the conversation, e.g. en, de, ja. Plan names and country names come back in it when available. Bare "en" is quoted in en-us / USD.
product_idYesProduct id from search_esim_plans or recommend_plan.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
apnNoAPN to set when the vendor requires one.
skuNoCatalogue SKU.
urlNoProduct page in pricing_bucket. Use verbatim.
dataNoData Pack: total data label, e.g. "5GB".
daysNoValidity in days (Data Pack, Daily Pack).
nameNoShort plan name: destination · data · validity · type.
typeNoPlan type.
priceNoPrice in currency, read WITH price_basis: the full price of the plan when "total", the price of ONE day when "per_day". Never a per-GB rate. The price shown is the price paid.
titleNoFull product title in the requested language.
topupNoTop-up possibility for this plan.
ratingNoAverage customer rating (1-5). Present only when reviews exist.
data_gbNoData amount in GB. Meaning given by data_period.
hotspotNoHotspot / tethering rule as the vendor states it, e.g. "Supported" or a device limit.
summaryNoShort description in the requested language, from the product page.
currencyNoISO 4217 currency of every price in this object.
fair_useNoFair-use policy text from the supplier, when stated.
networksNoOperator names across the plan (deduplicated). Per-country detail is in coverage_countries.
validityNoValidity label, e.g. "30 days".
plan_noteNoOne-sentence vendor fact to present verbatim when present; overrides the generic type description.
price_maxNoOnly on price_basis "per_day": the price for the longest duration in days_range, discount applied — the figure to quote for a full period. Never infer it by multiplying.
speed_capNoPresent only on plans with a PERMANENT speed cap, e.g. "10 Mbit/s". Never call such a plan high-speed.
voice_smsNoAlways "none": data only, no telephone number, no SMS.
covers_viaNoPresent when the plan was returned for a country it covers as part of a multi-country plan: the plan's own region name.
days_rangeNoUnlimited Flex: choosable durations in days, e.g. "1-30".
expires_onNoStock expiry date (YYYY-MM-DD) when the product itself has one.
product_idNoProduct id. Use it for get_plan_details and start_checkout.
data_periodNo"total": data_gb is the whole plan (Data Pack). "per_day": data_gb is the daily full-speed allowance (Unlimited Flex, Daily Pack).
ip_breakoutNoCountry whose internet connection the customer appears to use (IP breakout), ISO code(s) — matters for banking apps, streaming and mainland-China access. Vendor fact.
price_basisNoWhat `price` means.
refund_ruleNoThe refund class in words - present verbatim.
kyc_requiredNotrue when the vendor requires real-name registration (ID verification) on arrival before data works.
last_updatedNoDate the plan was last updated in the catalogue (YYYY-MM-DD).
refund_classNoVendor refund/cancellation class for this plan.
review_countNoNumber of reviews. Present only when > 0.
transparencyNoA per-order Transparency link shows remaining data in near real-time.
coverage_noteNoCoverage caveat to present verbatim, e.g. traffic routed via Hong Kong.
always_on_rateNoUnlimited Flex / Daily Pack: reduced speed after the daily allowance, e.g. "512 Kbit/s". Empty when the plan has a speed_cap or is unlimited.
coverage_countNoNumber of countries in coverage_countries.
price_is_finalNoAlways true: no tax or fee is added at checkout.
pricing_bucketNolanguage-region bucket the prices and links are quoted in, e.g. "en-us".
daily_high_speedNoUnlimited Flex / Daily Pack: daily allowance at full speed, e.g. "2GB"; "unlimited" = unlimited data every day at full speed (fair-use policy).
daily_reset_timeNoWhen the daily allowance resets, as the vendor states it (clock and time zone). Absent = resets 24 h after activation is NOT implied; simply unknown.
unused_valid_daysNoDays the eSIM may remain unused after purchase before it expires (supplier value).
activation_triggerNo"install": validity and billing start the moment the eSIM is installed — install only when ready to use. "first_connection": the eSIM can be installed before travel; validity starts on first connection to a network at the destination.
coverage_countriesNoEvery country the plan works in, with the network operators per country when known.
network_generationNoNetwork technology, e.g. "4G/LTE/5G". Never an operator name.
start_date_requiredNotrue when a start date must be chosen at checkout.
install_before_travelNotrue when the eSIM can safely be installed before departure (activation_trigger first_connection).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / last_updated
      Added value: +{
      +  "description": "Date the plan was last updated in the catalogue (YYYY-MM-DD).",
      +  "type": "string"
      +}
    • removedOutput schema / properties / last_verified
      Removed value: -{
      -  "description": "Date the plan facts were last synchronised from the supplier (YYYY-MM-DD), when known.",
      -  "type": "string"
      -}
  2. Changed60 schema fields changed
    • addedInput schema / properties / bucket
      Added value: +{
      +  "description": "Optional language-region bucket the customer shops in, e.g. \"en-gb\", \"de-de\". Wins over language; prices and links are quoted in it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / currency
      Added value: +{
      +  "description": "Optional ISO 4217 code. Every price in the result is quoted in it.",
      +  "type": "string"
      +}
    • changedInput schema / properties / language / description
      Previous value: -"ISO language of the conversation. Sets the landing-page language/currency of the link."New value: +"ISO language of the conversation, e.g. en, de, ja. Plan names and country names come back in it when available. Bare \"en\" is quoted in en-us / USD."
    • changedInput schema / properties / product_id / description
      Previous value: -"WooCommerce product id from search_esim_plans."New value: +"Product id from search_esim_plans or recommend_plan."
    • addedOutput schema / description
      Added value: +"One eSIM plan. Every field is present only when the catalogue holds a value for it; an absent field is unknown, never \"no\"."
    • addedOutput schema / properties / activation_trigger
      Added value: +{
      +  "description": "\"install\": validity and billing start the moment the eSIM is installed — install only when ready to use. \"first_connection\": the eSIM can be installed before travel; validity starts on first connection to a network at the destination.",
      +  "enum": [
      +    "install",
      +    "first_connection"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / always_on_rate / description
      Previous value: -"Unlimited Flex / Daily Pack: reduced rate after the daily allowance. Empty when the plan has a speed_cap (no reduction moment) or is unlimited."New value: +"Unlimited Flex / Daily Pack: reduced speed after the daily allowance, e.g. \"512 Kbit/s\". Empty when the plan has a speed_cap or is unlimited."
    • addedOutput schema / properties / apn
      Added value: +{
      +  "description": "APN to set when the vendor requires one.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / coverage_count
      Added value: +{
      +  "description": "Number of countries in coverage_countries.",
      +  "type": "integer"
      +}
    • addedOutput schema / properties / coverage_countries
      Added value: +{
      +  "description": "Every country the plan works in, with the network operators per country when known.",
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "iso": {
      +        "description": "ISO 3166-1 alpha-2, lowercase.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Country name in the requested language.",
      +        "type": "string"
      +      },
      +      "networks": {
      +        "description": "Operator names in that country, as the supplier lists them.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / coverage_note
      Added value: +{
      +  "description": "Coverage caveat to present verbatim, e.g. traffic routed via Hong Kong.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / covers_via
      Added value: +{
      +  "description": "Present when the plan was returned for a country it covers as part of a multi-country plan: the plan's own region name.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / currency / description
      Added value: +"ISO 4217 currency of every price in this object."
    • addedOutput schema / properties / daily_reset_time
      Added value: +{
      +  "description": "When the daily allowance resets, as the vendor states it (clock and time zone). Absent = resets 24 h after activation is NOT implied; simply unknown.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / data / description
      Previous value: -"Data Pack: total data label."New value: +"Data Pack: total data label, e.g. \"5GB\"."
    • addedOutput schema / properties / data_gb / description
      Added value: +"Data amount in GB. Meaning given by data_period."
    • addedOutput schema / properties / data_period
      Added value: +{
      +  "description": "\"total\": data_gb is the whole plan (Data Pack). \"per_day\": data_gb is the daily full-speed allowance (Unlimited Flex, Daily Pack).",
      +  "enum": [
      +    "total",
      +    "per_day"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / days
      Added value: +{
      +  "description": "Validity in days (Data Pack, Daily Pack).",
      +  "type": "integer"
      +}
    • changedOutput schema / properties / days_range / description
      Previous value: -"Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-30\"."New value: +"Unlimited Flex: choosable durations in days, e.g. \"1-30\"."
    • removedOutput schema / properties / description
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / expires_on
      Added value: +{
      +  "description": "Stock expiry date (YYYY-MM-DD) when the product itself has one.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / fair_use
      Added value: +{
      +  "description": "Fair-use policy text from the supplier, when stated.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / hotspot
      Added value: +{
      +  "description": "Hotspot / tethering rule as the vendor states it, e.g. \"Supported\" or a device limit.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / install_before_travel
      Added value: +{
      +  "description": "true when the eSIM can safely be installed before departure (activation_trigger first_connection).",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / ip_breakout
      Added value: +{
      +  "description": "Country whose internet connection the customer appears to use (IP breakout), ISO code(s) — matters for banking apps, streaming and mainland-China access. Vendor fact.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / kyc_required
      Added value: +{
      +  "description": "true when the vendor requires real-name registration (ID verification) on arrival before data works.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / last_verified
      Added value: +{
      +  "description": "Date the plan facts were last synchronised from the supplier (YYYY-MM-DD), when known.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / name / description
      Added value: +"Short plan name: destination · data · validity · type."
    • removedOutput schema / properties / network
      Removed value: -{
      -  "description": "Speed token only (e.g. 4G/LTE/5G) — never a carrier/operator name.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / network_generation
      Added value: +{
      +  "description": "Network technology, e.g. \"4G/LTE/5G\". Never an operator name.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / networks
      Added value: +{
      +  "description": "Operator names across the plan (deduplicated). Per-country detail is in coverage_countries.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / plan_note / description
      Previous value: -"One-sentence vendor fact to present verbatim (in the user's language) when present; overrides the generic Unlimited Flex description."New value: +"One-sentence vendor fact to present verbatim when present; overrides the generic type description."
    • changedOutput schema / properties / price / description
      Previous value: -"Price in currency, to be read WITH price_basis: the full fixed price of the plan when price_basis is \"total\", the price of one day when it is \"per_day\". Never a per-GB rate."New value: +"Price in currency, read WITH price_basis: the full price of the plan when \"total\", the price of ONE day when \"per_day\". Never a per-GB rate. The price shown is the price paid."
    • changedOutput schema / properties / price_basis / description
      Previous value: -"What `price` means. \"total\" = the whole plan (Data Pack, Daily Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range and price_max is the longest-duration price."New value: +"What `price` means."
    • addedOutput schema / properties / price_is_final
      Added value: +{
      +  "description": "Always true: no tax or fee is added at checkout.",
      +  "type": "boolean"
      +}
    • changedOutput schema / properties / price_max / description
      Previous value: -"Only on price_basis \"per_day\": the price for the longest duration in days_range, discount already applied — the figure to quote for a full period. Absent when it cannot be computed; never infer it by multiplying price."New value: +"Only on price_basis \"per_day\": the price for the longest duration in days_range, discount applied — the figure to quote for a full period. Never infer it by multiplying."
    • addedOutput schema / properties / pricing_bucket
      Added value: +{
      +  "description": "language-region bucket the prices and links are quoted in, e.g. \"en-us\".",
      +  "type": "string"
      +}
    • addedOutput schema / properties / product_id / description
      Added value: +"Product id. Use it for get_plan_details and start_checkout."
    • addedOutput schema / properties / rating / description
      Added value: +"Average customer rating (1-5). Present only when reviews exist."
    • addedOutput schema / properties / refund_class
      Added value: +{
      +  "description": "Vendor refund/cancellation class for this plan.",
      +  "enum": [
      +    "until_install",
      +    "non_refundable",
      +    "no_cancel"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / refund_rule
      Added value: +{
      +  "description": "The refund class in words - present verbatim.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / review_count / description
      Added value: +"Number of reviews. Present only when > 0."
    • addedOutput schema / properties / sku
      Added value: +{
      +  "description": "Catalogue SKU.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / speed_cap / description
      Previous value: -"Present only on plans with a PERMANENT speed cap, e.g. \"10 Mbit/s\": the plan always runs at up to this speed with the daily allowance in daily_high_speed. Do not call such a plan high-speed."New value: +"Present only on plans with a PERMANENT speed cap, e.g. \"10 Mbit/s\". Never call such a plan high-speed."
    • addedOutput schema / properties / start_date_required
      Added value: +{
      +  "description": "true when a start date must be chosen at checkout.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / summary
      Added value: +{
      +  "description": "Short description in the requested language, from the product page.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tethering
      Removed value: -{
      -  "type": "boolean"
      -}
    • addedOutput schema / properties / title
      Added value: +{
      +  "description": "Full product title in the requested language.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / topup / additionalProperties
      Added value: +true
    • changedOutput schema / properties / topup / description
      Previous value: -"True only for data top-up (add data to a Data Pack). See topup_kind for the full picture."New value: +"Top-up possibility for this plan."
    • addedOutput schema / properties / topup / properties
      Added value: +{
      +  "how": {
      +    "description": "How the customer tops up.",
      +    "type": "string"
      +  },
      +  "kind": {
      +    "description": "What TopUp can add without a new eSIM: data (Data Pack), days (Unlimited Flex / Daily Pack), or none.",
      +    "enum": [
      +      "data",
      +      "days",
      +      "none"
      +    ],
      +    "type": "string"
      +  }
      +}
    • changedOutput schema / properties / topup / type
      Previous value: -"boolean"New value: +"object"
    • removedOutput schema / properties / topup_kind
      Removed value: -{
      -  "description": "What eSIM-Global.VIP TopUp can add to this plan without a new eSIM: \"data\" (Data Pack), \"days\" (Unlimited Flex / Daily Pack: extend validity), or \"none\".",
      -  "enum": [
      -    "data",
      -    "days",
      -    "none"
      -  ],
      -  "type": "string"
      -}
    • addedOutput schema / properties / transparency / description
      Added value: +"A per-order Transparency link shows remaining data in near real-time."
    • changedOutput schema / properties / type / description
      Previous value: -"Data Pack, Daily Pack or Unlimited Flex."New value: +"Plan type."
    • addedOutput schema / properties / type / enum
      Added value: +[
      +  "Data Pack",
      +  "Daily Pack",
      +  "Unlimited Flex"
      +]
    • addedOutput schema / properties / unused_valid_days
      Added value: +{
      +  "description": "Days the eSIM may remain unused after purchase before it expires (supplier value).",
      +  "type": "integer"
      +}
    • addedOutput schema / properties / url / description
      Added value: +"Product page in pricing_bucket. Use verbatim."
    • changedOutput schema / properties / validity / description
      Previous value: -"Data Pack: validity label."New value: +"Validity label, e.g. \"30 days\"."
    • addedOutput schema / properties / voice_sms
      Added value: +{
      +  "description": "Always \"none\": data only, no telephone number, no SMS.",
      +  "type": "string"
      +}
  3. Changed4 schema fields changed
    • addedOutput schema / properties / days_range
      Added value: +{
      +  "description": "Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-30\".",
      +  "type": "string"
      +}
    • changedOutput schema / properties / price / description
      Previous value: -"Full fixed price in currency; not per-day or per-GB."New value: +"Price in currency, to be read WITH price_basis: the full fixed price of the plan when price_basis is \"total\", the price of one day when it is \"per_day\". Never a per-GB rate."
    • addedOutput schema / properties / price_basis
      Added value: +{
      +  "description": "What `price` means. \"total\" = the whole plan (Data Pack, Daily Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range and price_max is the longest-duration price.",
      +  "enum": [
      +    "total",
      +    "per_day"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / price_max
      Added value: +{
      +  "description": "Only on price_basis \"per_day\": the price for the longest duration in days_range, discount already applied — the figure to quote for a full period. Absent when it cannot be computed; never infer it by multiplying price.",
      +  "type": "number"
      +}
  4. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/openWorld, so the safety profile is covered. The description adds real behavioral context beyond them: prices and links are quoted per the customer's bucket or currency, and it enumerates the fact categories returned, which helps the agent know what it is asking for.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence that front-loads the verb and the identifying key (product id) before the long facet enumeration. The list is heavy but each item names a distinct returned facet, so little is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With annotations covering the safety profile and an output schema presumably documenting the return shape, the description is complete enough: it names the lookup key, the override semantics for pricing, and the scope of facts. Nothing critical for a correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so bucket, currency, language and product_id are fully documented in the schema. The description only restates the quoting behavior ('quoted in the customer's bucket or currency when given') without adding syntax or precedence detail beyond what the schema already gives.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Full facts for one eSIM-Global.VIP plan by product id') and enumerates the exact facets returned (coverage, data rules, hotspot/APN, top-up, refund, price basis, reviews). This clearly separates it from search_esim_plans and recommend_plan, which supply the id this tool consumes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The singular 'one plan by product id' framing implies this is the detail-lookup step after a search or recommendation, but there is no explicit when-to-use/when-not statement or named alternative. Usage is only inferred from the phrase 'by product id'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources