Skip to main content
Glama

Get plan details

get_plan_details
Read-onlyIdempotent

Full facts for one IbiPoint plan by product id: coverage with networks per country, data and speed rules, activation and validity rules, top-up, tethering, price with basis (per-day plans: price_30_days and price_max), 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
skuNoCatalogue SKU.
urlNoProduct page in pricing_bucket. Use verbatim.
dataNoData Pack: total data label, e.g. "5GB".
daysNoValidity in days (Data 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.
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 (365 days), discount applied. Never infer it by multiplying.
tetheringNoHotspot / tethering is supported where the network and device allow it (shop rule).
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, "1-365".
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).
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.
last_updatedNoDate the plan was last updated in the catalogue (YYYY-MM-DD).
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.
price_30_daysNoOnly on price_basis "per_day": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Never infer it by multiplying.
always_on_rateNoUnlimited Flex: reduced speed after the daily allowance, e.g. "512 Kbit/s". Empty when the plan 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 allowance at full speed, e.g. "2GB"; "unlimited" = unlimited data every day at full speed (fair-use policy).
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.
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. Changed53 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: reduced rate after the daily allowance."New value: +"Unlimited Flex: reduced speed after the daily allowance, e.g. \"512 Kbit/s\". Empty when the plan is unlimited."
    • 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."
    • changedOutput schema / properties / daily_high_speed / description
      Previous value: -"Unlimited Flex: daily high-speed allowance."New value: +"Unlimited Flex: daily allowance at full speed, e.g. \"2GB\"; \"unlimited\" = unlimited data every day at full speed (fair-use policy)."
    • 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).",
      +  "enum": [
      +    "total",
      +    "per_day"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / days
      Added value: +{
      +  "description": "Validity in days (Data 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-365\"."New value: +"Unlimited Flex: choosable durations in days, \"1-365\"."
    • 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 / 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 / last_updated
      Added value: +{
      +  "description": "Date the plan was last updated in the catalogue (YYYY-MM-DD).",
      +  "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"
      +}
    • addedOutput schema / properties / plan_note
      Added value: +{
      +  "description": "One-sentence vendor fact to present verbatim when present; overrides the generic type description.",
      +  "type": "string"
      +}
    • 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_30_days / description
      Previous value: -"Only on price_basis \"per_day\": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Absent when it cannot be computed; never infer it by multiplying price."New value: +"Only on price_basis \"per_day\": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Never infer it by multiplying."
    • changedOutput schema / properties / price_basis / description
      Previous value: -"What `price` means. \"total\" = the whole plan (Data Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range; see price_30_days and price_max."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 applied. 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 (365 days), discount applied. 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 / review_count / description
      Added value: +"Number of reviews. Present only when > 0."
    • addedOutput schema / properties / sku
      Added value: +{
      +  "description": "Catalogue SKU.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / summary
      Added value: +{
      +  "description": "Short description in the requested language, from the product page.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / tethering / description
      Added value: +"Hotspot / tethering is supported where the network and device allow it (shop rule)."
    • addedOutput schema / properties / title
      Added value: +{
      +  "description": "Full product title in the requested language.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / topup / additionalProperties
      Added value: +true
    • addedOutput schema / properties / topup / description
      Added 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), or none.",
      +    "enum": [
      +      "data",
      +      "days",
      +      "none"
      +    ],
      +    "type": "string"
      +  }
      +}
    • changedOutput schema / properties / topup / type
      Previous value: -"boolean"New value: +"object"
    • 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 or Unlimited Flex."New value: +"Plan type."
    • addedOutput schema / properties / type / enum
      Added value: +[
      +  "Data 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"
      +}
  2. Changed5 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-365\".",
      +  "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_30_days
      Added value: +{
      +  "description": "Only on price_basis \"per_day\": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Absent when it cannot be computed; never infer it by multiplying price.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / price_basis
      Added value: +{
      +  "description": "What `price` means. \"total\" = the whole plan (Data Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range; see price_30_days and price_max.",
      +  "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 applied. Absent when it cannot be computed; never infer it by multiplying price.",
      +  "type": "number"
      +}
  3. 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 read-only, idempotent, open-world, non-destructive, so the safety profile is covered. The description still adds real behavioral context: quotes are localized to the provided bucket/currency, and pricing is returned with an explicit basis, including price_30_days and price_max for per-day plans. It does not discuss rate limits or pagination, but for a read-only lookup that is minor.

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 front-loaded sentence that opens with the core action ('Full facts for one IbiPoint plan by product id') before the field list. It is dense and every clause maps to returned content, though the long comma-chain of fields makes it slightly heavy for a one-sentence description.

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 an output schema present, the description need not detail return structure, yet it still names the major returned sections, which is helpful. Combined with annotations and full schema coverage, an agent has everything needed to call it correctly; only the when-to-use relationship to siblings is unstated.

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 the baseline is 3: bucket, currency, language and product_id are all already documented with precedence (bucket wins over language). The description only echoes the quoting behavior ('quoted in the customer's bucket or currency when given') and adds no format or edge-case detail beyond the schema.

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 and resource (retrieve full facts for one plan) scoped tightly by product id, then enumerates exactly what those facts are: coverage/networks, data and speed rules, activation, validity, top-up, tethering, pricing, reviews. This clearly separates it from the sibling search_esim_plans (discovery) and recommend_plan (suggestion), since it is the single-plan lookup keyed by an id those tools produce.

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 phrase 'by product id' and the schema note that the id comes from search_esim_plans or recommend_plan imply the follow-up-detail workflow, but the description itself never states when to call this versus those siblings, nor any precondition or exclusion. Usage is inferable rather than declared.

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