Skip to main content
Glama

Plan costs as the workload changes

cost_scenarios
Read-onlyIdempotent

Use this when: the user asks how the cost changes as the workload grows or shifts, or at what volume another plan becomes the cheapest. Do not use this when: the workload is fixed (use search). Show how API plan costs change when the monthly workload changes, for example twice the pages or a larger share of JavaScript pages. Along the path from the current to a target workload it returns the cheapest fully matching plan at both ends, each workload where the cheapest plan changes, and for tracked plans where the cost first steps up, where the plan can no longer cover the volume and where the budget is exceeded. Costs follow published pricing rules (whole packs of extra credits, per-period pack limits, per-connection browser billing, monthly minimums) with official source sentences. Example: 10,000 searches a month growing to 200,000.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
scaleNoMultiply every monthly count by this factor for the end of the path, e.g. 2 for twice the current workload. Give target or scale.
detailNosummary returns one source sentence per fact; full returns every recorded fact and sentence.summary
targetNoWorkload at the end of the path; fields not given keep their current value. Give target or scale.
mcp_authNoWays to authenticate to the provider's hosted MCP endpoint, any one of which will do: api_key, oauth. Met when the endpoint accepts at least one of them; implies a hosted endpoint.
needs_zdrNoZero data retention must be usable on this plan. A provider that offers it only on a custom enterprise agreement does not meet it on its listed plans.
offer_idsNoCompare only these plans and follow each of them along the path. Default: every plan that can serve the workload, following the cheapest full match at the start.
preferredNoNice-to-have conditions; they do not filter, they break ties.
needs_soc2NoThe provider must hold a SOC 2 report: true for Type I or Type II, "II" for Type II.
needs_batchNoThe plan must transcribe recorded audio (a file or a stored recording), for speech-to-text. A plan priced for live audio only is not met.
data_regionsNoRegions where data must be stored or processed, e.g. ["EU"]. Different from exit-IP countries.
needs_koreanNoThe service must voice Korean text (text-to-speech) or transcribe Korean speech (speech-to-text).
billing_typesNoAcceptable billing: monthly_subscription (A plan with a fixed fee (or minimum commitment) billed every month.) annual_subscription (A plan paid for a year at a time.) pay_as_you_go (No plan fee; a price per unit of use, billed after use or drawn from a balance topped up with any amount.) prepaid_credits (Money paid before use: a credit pack, a balance topped up first, or a plan amount charged in advance for the period.) Free plans always qualify.
monthly_pagesNoPages per month by type: plain_html (static pages), javascript (needs rendering), premium_proxy (blocked sites that need residential/premium proxies), javascript_premium_proxy (both).
needs_inboundNoThe service must receive email for the buyer and hand it on (inbound parsing, routes), for transactional email.
product_typesNoLimit to these product types. Default: every type that can serve the workload.
search_enginesNoSearch engines whose results the plan must return, each at the plan's search price: google, bing, yahoo, yandex, baidu, duckduckgo, naver, brave (brave is Brave's own index). monthly_searches is the total over all of them.
captcha_solvingNoThe plan must solve CAPTCHAs for the browser sessions (the vendor does it, not the buyer own service).
min_concurrencyNoMinimum number of concurrent requests (or browsers) the plan must allow.
needs_streamingNoThe service must return audio in real time as it is made (streaming or a WebSocket), for text-to-speech; for speech-to-text, it must transcribe live audio as it arrives. A speech-to-text price line is per mode, so a plan priced for recorded audio only is not met.
monthly_searchesNoSearch requests per month (one results page each).
needs_remote_mcpNoThe provider must host a remote MCP endpoint (a URL an MCP client connects to). An official server that can only be run on the buyer own machine does not meet it.
proxies_includedNoThe plan must include proxy traffic of the vendor (some gigabytes in the plan fee). Proxy traffic sold only per gigabyte on top of the fee, or only on another plan, does not count.
search_countriesNoISO 3166-1 alpha-2 codes of the countries whose search results the searches must return (the search engine's country setting, e.g. Google gl), e.g. ["GB","CA"]. Different from exit_ip_countries.
exit_ip_countriesNoISO 3166-1 alpha-2 codes of countries the page requests must exit from, e.g. ["US","DE"]. For search results of a country use search_countries.
min_pages_per_docNoPages one document may have at the most the plan allows, for document parsing. Met when the stated limit is at least this many (or the pages say there is no page limit); a plan whose pages do not state a limit is unknown. The limit of the largest way of sending (batch or asynchronous) counts.
needs_diarizationNoThe plan must label who spoke (speaker diarization), for speech-to-text. Where the vendor charges extra for it, the extra price is added to the monthly cost; where the pages state no price or no inclusion the plan is unknown.
needs_no_trainingNoAn official page must say the vendor does not use the buyer's text, audio or documents to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count.
session_recordingNoThe plan must record browser sessions (video or replay) that the buyer can watch afterwards.
needs_dedicated_ipNoThe plan must come with a dedicated sending IP address, for transactional email. A dedicated IP sold only as an add-on on top of the plan, or only on another plan, does not count.
needs_official_mcpNoThe provider must publish its own MCP server (hosted by it or run by the buyer), stated in its official documentation. A server only a third party published does not count.
ai_extraction_pagesNoHow many of the pages need their fields extracted by an AI model (from a prompt or a schema, or automatically) without writing selectors. Each page counts in one of the two extraction fields.
min_pages_per_crawlNoPages one crawl job (from one start URL, following links) must be able to reach. A plan whose crawl has no page cap meets any number; give the size of the largest site to crawl. Different from the monthly page total.
min_sending_domainsNoSending domains the plan must let one account authenticate, for transactional email. Met when the stated limit is at least this many (or the pages say it is unlimited); a plan whose pages do not state a limit is unknown.
min_session_minutesNoMinutes one browser session must be able to run on this plan, for hosted browsers. Met when the stated longest session of the plan is at least this long; a plan whose pages do not state a session limit is unknown, and a limit the page gives only for another plan is not met.
monthly_pages_totalNoTotal pages per month when the split by type is not known yet. Costs and verdicts then cover every share of JavaScript-rendered pages from 0% to 100% of the total (no premium proxies), and the result lists monthly_pages under needs_input.
needs_voice_cloningNoThe plan must let the account clone a voice from its own recording, for text-to-speech. Cloning limited to eligible customers, a request form or an enterprise plan does not count for a plan that is not that plan.
persistent_profilesNoThe plan must keep browser profiles (login state, cookies) between sessions.
search_result_typesNoResult types the parsed search response must contain: organic, ads, local_pack, knowledge_graph, people_also_ask, related_searches, shopping, news, images, videos, ai_overview.
max_monthly_cost_usdNoMonthly budget in USD before tax. Compared with listed prices; annual plans use their per-month equivalent.
needs_batch_discountNoAn official page must say a batch or asynchronous way of sending documents costs less than the list price on the plan, for document parsing. The budget and the cost are judged at the list price, not at the batch price.
needs_commercial_useNoThe plan must allow commercial use of the generated audio, for text-to-speech. A free plan limited to non-commercial use does not count; a plan whose pages do not say is unknown.
needs_no_min_billingNoAn official page must say audio is billed by the second (or an increment of seconds) with no minimum billed duration per request, for speech-to-text. A page that says nothing about rounding is unknown.
max_overage_usd_per_1kNoThe most the plan may charge for each 1,000 emails beyond its included volume, in USD, for transactional email. A plan whose extra price is not published as a per-1,000 figure is unknown.
min_log_retention_daysNoDays the plan must keep the logs or events of sent email where the account can read them, for transactional email. Longer retention sold as an add-on does not count.
needs_table_extractionNoThe service must return the tables of a page as structure (rows and cells), not only the text, for document parsing.
search_returns_contentNoThe search response itself must carry the text of the result pages (extracted content), not only titles, links and snippets.
min_requests_per_minuteNoMinimum request rate the plan must allow, per minute.
browser_seconds_per_pageNoBrowser time per page in seconds, for headless-browser products billed by time. Every plan must then serve pages that take this long: a hosted browser does, a request-based API only when one request may run that long.
realtime_search_requiredNoSearch results must be returned in real time (not through a queue).
target_errors_not_billedNoError responses from the target site (e.g. 404) must not be billed.
needs_recurring_free_tierNoThe plan must be usable every month without paying (a free plan with a monthly allowance or a monthly free credit).
failed_requests_not_billedNoRequests that fail on the provider side (timeouts, blocks, 5xx) must not be billed. A flat monthly price for unlimited requests meets it, since no request is billed on its own; when only success-based billing will do, use only_successful_requests_billed.
structured_extraction_pagesNoHow many of the pages must come back as JSON fields rather than HTML or text, by any method the plan offers (CSS or XPath selectors, a schema, or AI). When the fields must be found without writing selectors, use ai_extraction_pages instead; each page counts in one of the two.
only_successful_requests_billedNoBilling must count successful requests only: each successful request is charged (or draws credits) and failed ones cost nothing. A flat monthly price for unlimited requests does not meet it, since the price is the same whatever succeeds.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
pathYes
as_ofYes
notesYes
plansYesEvery plan named above, with the official facts its costs were computed from.
at_endYesUp to three cheapest full matches at the target workload.
countsYes
requestNo
trackedYes
at_startYesUp to three cheapest full matches at the current workload.
comparedYes
switchesYesEach workload on the path where the cheapest full match changes.
link_notesNoThe note of each link level (link.link_level) of the plans in this result, stated once.
assumptionsYes
needs_inputYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • addedInput schema / properties / min_pages_per_doc
      Added value: +{
      +  "description": "Pages one document may have at the most the plan allows, for document parsing. Met when the stated limit is at least this many (or the pages say there is no page limit); a plan whose pages do not state a limit is unknown. The limit of the largest way of sending (batch or asynchronous) counts.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / needs_batch_discount
      Added value: +{
      +  "description": "An official page must say a batch or asynchronous way of sending documents costs less than the list price on the plan, for document parsing. The budget and the cost are judged at the list price, not at the batch price.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / needs_no_training / description
      Previous value: -"An official page must say the vendor does not use the buyer's text and audio to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count."New value: +"An official page must say the vendor does not use the buyer's text, audio or documents to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count."
    • addedInput schema / properties / needs_table_extraction
      Added value: +{
      +  "description": "The service must return the tables of a page as structure (rows and cells), not only the text, for document parsing.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / min_pages_per_doc
      Added value: +{
      +  "description": "Pages one document may have at the most the plan allows, for document parsing. Met when the stated limit is at least this many (or the pages say there is no page limit); a plan whose pages do not state a limit is unknown. The limit of the largest way of sending (batch or asynchronous) counts.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / preferred / properties / needs_batch_discount
      Added value: +{
      +  "description": "An official page must say a batch or asynchronous way of sending documents costs less than the list price on the plan, for document parsing. The budget and the cost are judged at the list price, not at the batch price.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / preferred / properties / needs_no_training / description
      Previous value: -"An official page must say the vendor does not use the buyer's text and audio to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count."New value: +"An official page must say the vendor does not use the buyer's text, audio or documents to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count."
    • addedInput schema / properties / preferred / properties / needs_table_extraction
      Added value: +{
      +  "description": "The service must return the tables of a page as structure (rows and cells), not only the text, for document parsing.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / product_types / items / enum
      Previous value: -[
      -  "scraping_api",
      -  "serp_api",
      -  "headless_browser",
      -  "platform",
      -  "email_api",
      -  "tts_api",
      -  "stt_api"
      -]New value: +[
      +  "scraping_api",
      +  "serp_api",
      +  "headless_browser",
      +  "platform",
      +  "email_api",
      +  "tts_api",
      +  "stt_api",
      +  "docparse_api"
      +]
  2. Changed27 schema fields changed
    • addedInput schema / properties / max_overage_usd_per_1k
      Added value: +{
      +  "description": "The most the plan may charge for each 1,000 emails beyond its included volume, in USD, for transactional email. A plan whose extra price is not published as a per-1,000 figure is unknown.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / min_log_retention_days
      Added value: +{
      +  "description": "Days the plan must keep the logs or events of sent email where the account can read them, for transactional email. Longer retention sold as an add-on does not count.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / min_sending_domains
      Added value: +{
      +  "description": "Sending domains the plan must let one account authenticate, for transactional email. Met when the stated limit is at least this many (or the pages say it is unlimited); a plan whose pages do not state a limit is unknown.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / needs_batch
      Added value: +{
      +  "description": "The plan must transcribe recorded audio (a file or a stored recording), for speech-to-text. A plan priced for live audio only is not met.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_commercial_use
      Added value: +{
      +  "description": "The plan must allow commercial use of the generated audio, for text-to-speech. A free plan limited to non-commercial use does not count; a plan whose pages do not say is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_dedicated_ip
      Added value: +{
      +  "description": "The plan must come with a dedicated sending IP address, for transactional email. A dedicated IP sold only as an add-on on top of the plan, or only on another plan, does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_diarization
      Added value: +{
      +  "description": "The plan must label who spoke (speaker diarization), for speech-to-text. Where the vendor charges extra for it, the extra price is added to the monthly cost; where the pages state no price or no inclusion the plan is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_inbound
      Added value: +{
      +  "description": "The service must receive email for the buyer and hand it on (inbound parsing, routes), for transactional email.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_korean
      Added value: +{
      +  "description": "The service must voice Korean text (text-to-speech) or transcribe Korean speech (speech-to-text).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_no_min_billing
      Added value: +{
      +  "description": "An official page must say audio is billed by the second (or an increment of seconds) with no minimum billed duration per request, for speech-to-text. A page that says nothing about rounding is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_no_training
      Added value: +{
      +  "description": "An official page must say the vendor does not use the buyer's text and audio to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_streaming
      Added value: +{
      +  "description": "The service must return audio in real time as it is made (streaming or a WebSocket), for text-to-speech; for speech-to-text, it must transcribe live audio as it arrives. A speech-to-text price line is per mode, so a plan priced for recorded audio only is not met.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_voice_cloning
      Added value: +{
      +  "description": "The plan must let the account clone a voice from its own recording, for text-to-speech. Cloning limited to eligible customers, a request form or an enterprise plan does not count for a plan that is not that plan.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / max_overage_usd_per_1k
      Added value: +{
      +  "description": "The most the plan may charge for each 1,000 emails beyond its included volume, in USD, for transactional email. A plan whose extra price is not published as a per-1,000 figure is unknown.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / preferred / properties / min_log_retention_days
      Added value: +{
      +  "description": "Days the plan must keep the logs or events of sent email where the account can read them, for transactional email. Longer retention sold as an add-on does not count.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / preferred / properties / min_sending_domains
      Added value: +{
      +  "description": "Sending domains the plan must let one account authenticate, for transactional email. Met when the stated limit is at least this many (or the pages say it is unlimited); a plan whose pages do not state a limit is unknown.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / preferred / properties / needs_batch
      Added value: +{
      +  "description": "The plan must transcribe recorded audio (a file or a stored recording), for speech-to-text. A plan priced for live audio only is not met.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_commercial_use
      Added value: +{
      +  "description": "The plan must allow commercial use of the generated audio, for text-to-speech. A free plan limited to non-commercial use does not count; a plan whose pages do not say is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_dedicated_ip
      Added value: +{
      +  "description": "The plan must come with a dedicated sending IP address, for transactional email. A dedicated IP sold only as an add-on on top of the plan, or only on another plan, does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_diarization
      Added value: +{
      +  "description": "The plan must label who spoke (speaker diarization), for speech-to-text. Where the vendor charges extra for it, the extra price is added to the monthly cost; where the pages state no price or no inclusion the plan is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_inbound
      Added value: +{
      +  "description": "The service must receive email for the buyer and hand it on (inbound parsing, routes), for transactional email.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_korean
      Added value: +{
      +  "description": "The service must voice Korean text (text-to-speech) or transcribe Korean speech (speech-to-text).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_no_min_billing
      Added value: +{
      +  "description": "An official page must say audio is billed by the second (or an increment of seconds) with no minimum billed duration per request, for speech-to-text. A page that says nothing about rounding is unknown.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_no_training
      Added value: +{
      +  "description": "An official page must say the vendor does not use the buyer's text and audio to train its models without the buyer opting in. A use that is on by default with an opt-out to ask for does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_streaming
      Added value: +{
      +  "description": "The service must return audio in real time as it is made (streaming or a WebSocket), for text-to-speech; for speech-to-text, it must transcribe live audio as it arrives. A speech-to-text price line is per mode, so a plan priced for recorded audio only is not met.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_voice_cloning
      Added value: +{
      +  "description": "The plan must let the account clone a voice from its own recording, for text-to-speech. Cloning limited to eligible customers, a request form or an enterprise plan does not count for a plan that is not that plan.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / product_types / items / enum
      Previous value: -[
      -  "scraping_api",
      -  "serp_api",
      -  "headless_browser",
      -  "platform"
      -]New value: +[
      +  "scraping_api",
      +  "serp_api",
      +  "headless_browser",
      +  "platform",
      +  "email_api",
      +  "tts_api",
      +  "stt_api"
      +]
  3. Changed10 schema fields changed
    • addedInput schema / properties / captcha_solving
      Added value: +{
      +  "description": "The plan must solve CAPTCHAs for the browser sessions (the vendor does it, not the buyer own service).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / min_session_minutes
      Added value: +{
      +  "description": "Minutes one browser session must be able to run on this plan, for hosted browsers. Met when the stated longest session of the plan is at least this long; a plan whose pages do not state a session limit is unknown, and a limit the page gives only for another plan is not met.",
      +  "exclusiveMinimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / persistent_profiles
      Added value: +{
      +  "description": "The plan must keep browser profiles (login state, cookies) between sessions.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / captcha_solving
      Added value: +{
      +  "description": "The plan must solve CAPTCHAs for the browser sessions (the vendor does it, not the buyer own service).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / min_session_minutes
      Added value: +{
      +  "description": "Minutes one browser session must be able to run on this plan, for hosted browsers. Met when the stated longest session of the plan is at least this long; a plan whose pages do not state a session limit is unknown, and a limit the page gives only for another plan is not met.",
      +  "exclusiveMinimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / preferred / properties / persistent_profiles
      Added value: +{
      +  "description": "The plan must keep browser profiles (login state, cookies) between sessions.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / proxies_included
      Added value: +{
      +  "description": "The plan must include proxy traffic of the vendor (some gigabytes in the plan fee). Proxy traffic sold only per gigabyte on top of the fee, or only on another plan, does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / session_recording
      Added value: +{
      +  "description": "The plan must record browser sessions (video or replay) that the buyer can watch afterwards.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / proxies_included
      Added value: +{
      +  "description": "The plan must include proxy traffic of the vendor (some gigabytes in the plan fee). Proxy traffic sold only per gigabyte on top of the fee, or only on another plan, does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / session_recording
      Added value: +{
      +  "description": "The plan must record browser sessions (video or replay) that the buyer can watch afterwards.",
      +  "type": "boolean"
      +}
  4. Changed1 schema field changed
    • addedOutput schema / properties / plans / items / properties / plan_page
      Added value: +{
      +  "description": "The link to give the user with this plan, as a markdown link named \"<provider> <plan> — plan page\" (its pricing and sign-up page). The evidence sources under the conditions are for citing a condition.",
      +  "type": "string"
      +}
  5. Changed57 schema fields changed
    • addedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / plans / items / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / plans / items / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / plans / items / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / plans / items / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / plans / items / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • changedOutput schema / properties / plans / items / properties / link / properties / provider_url / description
      Previous value: -"The provider page itself, when url is this service's address that forwards to it."New value: +"The provider page itself. Only in a page made for a browser, where url is this service's address that forwards to it; MCP and REST results do not carry it."
    • addedOutput schema / properties / plans / items / properties / link / properties / url / description
      Added value: +"The only address to visit the plan: this service's /go/<offer_id>?r=<token> address, which forwards to the provider page. The token is made for this response and holds nothing about you."
    • addedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
    • addedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / at_limit / properties / evidence / properties / url
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / source
      Added value: +{
      +  "description": "Official page the sentence was found on.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / evidence / items / properties / url
      Removed value: -{
      -  "description": "Official page the sentence was found on.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / evidence / items / required
      Previous value: -[
      -  "url",
      -  "quote"
      -]New value: +[
      +  "source",
      +  "quote"
      +]
  6. Changed2 schema fields changed
    • changedInput schema / properties / billing_types / description
      Previous value: -"Acceptable billing: monthly_subscription (A plan with a fixed fee (or minimum commitment) billed every month.) annual_subscription (A plan paid for a year at a time.) pay_as_you_go (No plan fee; a price per unit of use, billed after use or drawn from a balance topped up with any amount.) prepaid_credits (A fixed-size credit pack bought before use, usually with an expiry.) Free plans always qualify."New value: +"Acceptable billing: monthly_subscription (A plan with a fixed fee (or minimum commitment) billed every month.) annual_subscription (A plan paid for a year at a time.) pay_as_you_go (No plan fee; a price per unit of use, billed after use or drawn from a balance topped up with any amount.) prepaid_credits (Money paid before use: a credit pack, a balance topped up first, or a plan amount charged in advance for the period.) Free plans always qualify."
    • changedInput schema / properties / preferred / properties / billing_types / description
      Previous value: -"Acceptable billing: monthly_subscription (A plan with a fixed fee (or minimum commitment) billed every month.) annual_subscription (A plan paid for a year at a time.) pay_as_you_go (No plan fee; a price per unit of use, billed after use or drawn from a balance topped up with any amount.) prepaid_credits (A fixed-size credit pack bought before use, usually with an expiry.) Free plans always qualify."New value: +"Acceptable billing: monthly_subscription (A plan with a fixed fee (or minimum commitment) billed every month.) annual_subscription (A plan paid for a year at a time.) pay_as_you_go (No plan fee; a price per unit of use, billed after use or drawn from a balance topped up with any amount.) prepaid_credits (Money paid before use: a credit pack, a balance topped up first, or a plan amount charged in advance for the period.) Free plans always qualify."
  7. Changed12 schema fields changed
    • addedInput schema / properties / mcp_auth
      Added value: +{
      +  "description": "Ways to authenticate to the provider's hosted MCP endpoint, any one of which will do: api_key, oauth. Met when the endpoint accepts at least one of them; implies a hosted endpoint.",
      +  "items": {
      +    "enum": [
      +      "api_key",
      +      "oauth"
      +    ],
      +    "type": "string"
      +  },
      +  "minItems": 1,
      +  "type": "array",
      +  "uniqueItems": true
      +}
    • addedInput schema / properties / needs_official_mcp
      Added value: +{
      +  "description": "The provider must publish its own MCP server (hosted by it or run by the buyer), stated in its official documentation. A server only a third party published does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_remote_mcp
      Added value: +{
      +  "description": "The provider must host a remote MCP endpoint (a URL an MCP client connects to). An official server that can only be run on the buyer own machine does not meet it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / needs_soc2
      Added value: +{
      +  "description": "The provider must hold a SOC 2 report: true for Type I or Type II, \"II\" for Type II.",
      +  "enum": [
      +    true,
      +    false,
      +    "II"
      +  ],
      +  "type": [
      +    "boolean",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / needs_zdr
      Added value: +{
      +  "description": "Zero data retention must be usable on this plan. A provider that offers it only on a custom enterprise agreement does not meet it on its listed plans.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / mcp_auth
      Added value: +{
      +  "description": "Ways to authenticate to the provider's hosted MCP endpoint, any one of which will do: api_key, oauth. Met when the endpoint accepts at least one of them; implies a hosted endpoint.",
      +  "items": {
      +    "enum": [
      +      "api_key",
      +      "oauth"
      +    ],
      +    "type": "string"
      +  },
      +  "minItems": 1,
      +  "type": "array",
      +  "uniqueItems": true
      +}
    • addedInput schema / properties / preferred / properties / needs_official_mcp
      Added value: +{
      +  "description": "The provider must publish its own MCP server (hosted by it or run by the buyer), stated in its official documentation. A server only a third party published does not count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_remote_mcp
      Added value: +{
      +  "description": "The provider must host a remote MCP endpoint (a URL an MCP client connects to). An official server that can only be run on the buyer own machine does not meet it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / needs_soc2
      Added value: +{
      +  "description": "The provider must hold a SOC 2 report: true for Type I or Type II, \"II\" for Type II.",
      +  "enum": [
      +    true,
      +    false,
      +    "II"
      +  ],
      +  "type": [
      +    "boolean",
      +    "string"
      +  ]
      +}
    • addedInput schema / properties / preferred / properties / needs_zdr
      Added value: +{
      +  "description": "Zero data retention must be usable on this plan. A provider that offers it only on a custom enterprise agreement does not meet it on its listed plans.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / preferred / properties / search_returns_content
      Added value: +{
      +  "description": "The search response itself must carry the text of the result pages (extracted content), not only titles, links and snippets.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / search_returns_content
      Added value: +{
      +  "description": "The search response itself must carry the text of the result pages (extracted content), not only titles, links and snippets.",
      +  "type": "boolean"
      +}
  8. Changed22 schema fields changed
    • addedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / plans / items / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / plans / items / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / at_limit
      Added value: +{
      +  "description": "Present for a plan with no automatic extra usage: what the official page says happens at the limit (kind no_extra_usage or restart_by_hand), with its sentence. With a workload that needs restarts, restarts gives their count, the price of each and the total, the numbers of monthly_cost.explanation.",
      +  "properties": {
      +    "evidence": {
      +      "properties": {
      +        "quote": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "enum": [
      +        "no_extra_usage",
      +        "restart_by_hand"
      +      ]
      +    },
      +    "restarts": {
      +      "properties": {
      +        "count": {
      +          "properties": {
      +            "high": {
      +              "type": "integer"
      +            },
      +            "low": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "total_usd": {
      +          "properties": {
      +            "high": {
      +              "type": "number"
      +            },
      +            "low": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "usd_each": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "text",
      +    "evidence"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / concurrency_unit
      Added value: +{
      +  "description": "get_details, concurrency only: the unit the page states the value in (unit, text such as \"100 threads\"). Against concurrent requests: equals_requests (value, text and the official line of the unit rule) when the unit rule counts this unit as requests, else note \"not the same unit as concurrent requests\"; \"unit not stated\" when the page names none.",
      +  "type": "object"
      +}
  9. Changed1 schema field changed
    • addedOutput schema / properties / plans / items / properties / link / properties / provider_url
      Added value: +{
      +  "description": "The provider page itself, when url is this service's address that forwards to it.",
      +  "type": "string"
      +}
  10. Changed10 schema fields changed
    • addedOutput schema / properties / link_notes
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "The note of each link level (link.link_level) of the plans in this result, stated once.",
      +  "type": "object"
      +}
    • removedOutput schema / properties / plans / items / properties / link / properties / note
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • changedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / conditions / items / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / cost_change / properties / conditions / items / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / cost_change / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / stops_matching / properties / conditions / items / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / stops_matching / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / volume_limit / properties / conditions / items / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
    • changedOutput schema / properties / tracked / items / properties / volume_limit / properties / verdict / enum
      Previous value: -[
      -  "MET",
      -  "UNMET",
      -  "UNKNOWN"
      -]New value: +[
      +  "MET",
      +  "UNMET",
      +  "UNKNOWN",
      +  "UNIT_MISMATCH",
      +  "UNIT_UNKNOWN"
      +]
  11. Changed11 schema fields changed
    • changedOutput schema / properties / at_end / items / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / at_start / items / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / plans / items / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / switches / items / properties / from / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / switches / items / properties / to / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / at_end / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / at_start / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / budget_exceeded / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / cost_change / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / stops_matching / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
    • changedOutput schema / properties / tracked / items / properties / volume_limit / properties / monthly_cost / properties / facts / items / properties / applies_to / description
      Previous value: -"get_details only: billing options the fact is limited to."New value: +"get_details only: billing options (billing) or search engines (search_engines) the fact is limited to."
  12. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint/idempotentHint/destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description goes further by disclosing the pricing model actually applied (whole packs of extra credits, per-period pack limits, per-connection browser billing, monthly minimums) and that costs are backed by official source sentences, which the annotations cannot convey. It stops short of noting how tie-breaking or unknown-plan cases are reported.

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?

The when/when-not routing is front-loaded in the first two clauses, and the example at the end anchors the abstract path language. The middle paragraph is dense and enumerates the pricing rules in one long sentence, but every clause carries information an agent needs to interpret the result.

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?

For a 54-parameter, nested-schema tool with an output schema present, the description covers the essentials: the growth-path framing, what is returned, the pricing rules and the official-source guarantee. Return-shape details are legitimately delegated to the output schema. Only tie-breaking and behavior when plans cannot serve the workload are left implicit.

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% across 54 parameters, so the schema already carries the parameter documentation burden. The description only illustrates scale/target usage ('twice the pages or a larger share of JavaScript pages', '10,000 searches a month growing to 200,000'), which adds concreteness but no semantics the schema lacks. Baseline 3 is appropriate.

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?

The description names a specific verb+resource ('show how API plan costs change when the monthly workload changes') and states exactly what is produced: the cheapest fully matching plan at both ends, each workload where the cheapest plan changes, and the step-up/coverage/budget thresholds. This is clearly distinguishable from siblings like search and check_conditions, which evaluate fixed conditions rather than a growth path.

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

Usage Guidelines5/5

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

Explicit routing is given in both directions: 'Use this when: the user asks how the cost changes as the workload grows or shifts' and 'Do not use this when: the workload is fixed (use search)', naming the alternative tool and the condition that selects it. Nothing is left to inference.

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