Skip to main content
Glama

Compare a plan's price across regions

compare_prices
Read-onlyIdempotent

Rank the price of one subscription plan (e.g. ChatGPT Plus, Claude Pro, Google AI Pro) across countries and regions, converted to one currency. Answers questions like "where is ChatGPT Plus cheapest?" or "how much is Claude Pro in Turkey?". Prices are monthly equivalents; for yearly billing the full-year total is also given. Each response includes when the prices and exchange rates were last updated.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "compare_prices"
  }
}

Input Schema

NameRequiredDescriptionDefault
taxNoOnly regions whose reference price has this tax label.all
pageNo
planNoPlan key from list_catalog, e.g. plus, pro, business (ChatGPT), claude_pro, gemini_ai_pro, perplexity_pro, supergrok. Defaults to the product's main plan.
sortNoasc: cheapest first (default); desc: most expensive first; name: alphabetical.asc
limitNoRows per page, 1–50.
localeNoLanguage for region and plan names: en (default) or zh.en
regionNoOptional filter by region code, name or currency, e.g. JP, Japan, 日本, EUR.
channelNoSales channel: web (regional website prices) or app_store (iOS). Defaults to web for ChatGPT and app_store for other products. Claude website reference prices use get_reference_prices.
productNoProduct key returned by list_catalog, including dynamically registered app_<apple-id> products.chatgpt
currencyNoISO 4217 currency for converted reference prices, e.g. USD, CNY, EUR. Defaults to USD for en and CNY for zh.
intervalNoUse unknown for observed App Store prices without a resolved period; these have no ranking or monthly equivalent.month

Output Schema

NameRequiredDescriptionDefault
urlYes
pageYes
planYes
rowsYes
unitYes
notesYes
channelYes
fxStaleYes
productYes
summaryYes
currencyYes
intervalYes
planNameYes
totalPagesYes
fxUpdatedAtYes
staleQuotesYes
observationsYesOriginal App Store observations with unknown billing periods, independent of the requested known interval.
dataUpdatedAtYes
oldestQuoteUpdatedAtYes
historicalObservationsYesHistorical amounts omitted from the latest partial Apple list; not current quotes and excluded from ranking, conversions, budgets and alerts.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / historicalObservations
      Added value: +{
      +  "description": "Historical amounts omitted from the latest partial Apple list; not current quotes and excluded from ranking, conversions, budgets and alerts.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "type": "string"
      +      },
      +      "currency": {
      +        "type": "string"
      +      },
      +      "fetchedAt": {
      +        "type": "string"
      +      },
      +      "interval": {
      +        "enum": [
      +          "month",
      +          "year"
      +        ],
      +        "type": "string"
      +      },
      +      "intervalSource": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "planKey": {
      +        "type": "string"
      +      },
      +      "regionCode": {
      +        "type": "string"
      +      },
      +      "regionName": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "not_observed",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "planKey",
      +      "name",
      +      "amount",
      +      "currency",
      +      "fetchedAt",
      +      "state",
      +      "regionCode",
      +      "regionName"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "product",
      -  "channel",
      -  "plan",
      -  "planName",
      -  "unit",
      -  "interval",
      -  "currency",
      -  "summary",
      -  "observations",
      -  "rows",
      -  "page",
      -  "totalPages",
      -  "dataUpdatedAt",
      -  "oldestQuoteUpdatedAt",
      -  "fxUpdatedAt",
      -  "staleQuotes",
      -  "fxStale",
      -  "notes",
      -  "url"
      -]New value: +[
      +  "product",
      +  "channel",
      +  "plan",
      +  "planName",
      +  "unit",
      +  "interval",
      +  "currency",
      +  "summary",
      +  "observations",
      +  "historicalObservations",
      +  "rows",
      +  "page",
      +  "totalPages",
      +  "dataUpdatedAt",
      +  "oldestQuoteUpdatedAt",
      +  "fxUpdatedAt",
      +  "staleQuotes",
      +  "fxStale",
      +  "notes",
      +  "url"
      +]
  2. Changed7 schema fields changed
    • changedInput schema / properties / interval / description
      Previous value: -"Billing interval: month (default) or year."New value: +"Use unknown for observed App Store prices without a resolved period; these have no ranking or monthly equivalent."
    • changedInput schema / properties / interval / enum
      Previous value: -[
      -  "month",
      -  "year"
      -]New value: +[
      +  "month",
      +  "year",
      +  "unknown"
      +]
    • changedOutput schema / properties / interval / enum
      Previous value: -[
      -  "month",
      -  "year"
      -]New value: +[
      +  "month",
      +  "year",
      +  "unknown"
      +]
    • addedOutput schema / properties / observations
      Added value: +{
      +  "description": "Original App Store observations with unknown billing periods, independent of the requested known interval.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "type": "string"
      +      },
      +      "currency": {
      +        "type": "string"
      +      },
      +      "fetchedAt": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "period": {
      +        "const": "unknown",
      +        "type": "string"
      +      },
      +      "regionCode": {
      +        "type": "string"
      +      },
      +      "regionName": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "regionCode",
      +      "regionName",
      +      "name",
      +      "amount",
      +      "currency",
      +      "fetchedAt",
      +      "period"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / rows / items / properties / periodBasis
      Added value: +{
      +  "enum": [
      +    "source",
      +    "pair",
      +    "default",
      +    "manual",
      +    "unknown"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / rows / items / required
      Previous value: -[
      -  "position",
      -  "regionCode",
      -  "regionName",
      -  "status",
      -  "localAmount",
      -  "localCurrency",
      -  "amountBasis",
      -  "tax",
      -  "referencePrice",
      -  "yearlyTotal",
      -  "vsUs",
      -  "quoteUpdatedAt",
      -  "stale"
      -]New value: +[
      +  "periodBasis",
      +  "position",
      +  "regionCode",
      +  "regionName",
      +  "status",
      +  "localAmount",
      +  "localCurrency",
      +  "amountBasis",
      +  "tax",
      +  "referencePrice",
      +  "yearlyTotal",
      +  "vsUs",
      +  "quoteUpdatedAt",
      +  "stale"
      +]
    • changedOutput schema / required
      Previous value: -[
      -  "product",
      -  "channel",
      -  "plan",
      -  "planName",
      -  "unit",
      -  "interval",
      -  "currency",
      -  "summary",
      -  "rows",
      -  "page",
      -  "totalPages",
      -  "dataUpdatedAt",
      -  "oldestQuoteUpdatedAt",
      -  "fxUpdatedAt",
      -  "staleQuotes",
      -  "fxStale",
      -  "notes",
      -  "url"
      -]New value: +[
      +  "product",
      +  "channel",
      +  "plan",
      +  "planName",
      +  "unit",
      +  "interval",
      +  "currency",
      +  "summary",
      +  "observations",
      +  "rows",
      +  "page",
      +  "totalPages",
      +  "dataUpdatedAt",
      +  "oldestQuoteUpdatedAt",
      +  "fxUpdatedAt",
      +  "staleQuotes",
      +  "fxStale",
      +  "notes",
      +  "url"
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / channel / description
      Previous value: -"Sales channel: web (ChatGPT website checkout, ChatGPT only) or app_store (iOS in-app purchase). Defaults to web for ChatGPT and app_store for other products."New value: +"Sales channel: web (regional website prices) or app_store (iOS). Defaults to web for ChatGPT and app_store for other products. Claude website reference prices use get_reference_prices."
  4. Changed4 schema fields changed
    • addedInput schema / properties / product / anyOf
      Added value: +[
      +  {
      +    "enum": [
      +      "chatgpt",
      +      "claude",
      +      "gemini",
      +      "perplexity",
      +      "grok"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "pattern": "^app_[1-9]\\d{5,14}$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / product / description
      Previous value: -"Product: chatgpt, claude, gemini, perplexity or grok."New value: +"Product key returned by list_catalog, including dynamically registered app_<apple-id> products."
    • removedInput schema / properties / product / enum
      Removed value: -[
      -  "chatgpt",
      -  "claude",
      -  "gemini",
      -  "perplexity",
      -  "grok"
      -]
    • removedInput schema / properties / product / type
      Removed value: -"string"
  5. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare a safe, read-only, idempotent, closed-world read, so the bar is lower. The description still adds substantive behavior: prices are monthly equivalents, yearly billing also reports the full-year total, and every response carries last-updated timestamps for prices and FX rates.

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

Conciseness5/5

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

Three tight sentences, front-loaded with the core action, then example questions, then output semantics. No sentence repeats the name or the annotations, and nothing is padding.

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 and 91% parameter coverage, the description only needs to convey intent and output shape, which it does. Minor gaps remain around paging/limit behavior and the web-vs-app_store channel distinction, both of which are left entirely to the schema.

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 91%, so parameters such as tax, sort, channel, interval and locale are already well documented. The description adds only the plan-example and currency-conversion framing, which the schema largely covers; baseline 3 is appropriate.

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

Purpose4/5

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

The description gives a specific verb and resource: rank one subscription plan's price across countries/regions in a single currency, with concrete plan examples. It is clear what the tool returns, but it never names a sibling (e.g. get_region_prices or get_reference_prices) so the boundary with alternatives must be inferred from schemas.

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

Usage Guidelines4/5

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

Two natural-language example questions ("where is ChatGPT Plus cheapest?", "how much is Claude Pro in Turkey?") make the intended use case unambiguous. There are no explicit when-not conditions, and the Claude/get_reference_prices routing hint lives only in the schema rather than the description.

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.