Skip to main content
Glama

Web Data API Plan Finder

Server Details

Compare web scraping, crawling and SERP API pricing and limits against your workload and budget

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP ยท MCP 2025-11-25
URL

TDQS

A4.4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose, reinforced by explicit 'Use this when' and 'Do not use this when' clauses. search is for discovery, check_conditions for validating named plans, cost_scenarios for varying workloads, get_details for retrieving full details, and relax_conditions for suggesting condition changes. No two tools overlap in trigger or output.

Naming Consistency4/5

All names use snake_case, which is consistent. However, 'cost_scenarios' is a noun phrase rather than a verb_noun pattern, and 'search' is a bare verb, creating minor deviations from the otherwise consistent verb_noun convention (check_conditions, get_details, relax_conditions).

Tool Count5/5

With 5 tools, the set is well-scoped for a plan-finder domain. Each tool covers a distinct facet: discovery, verification, cost analysis, detail retrieval, and condition relaxation. No tool feels redundant or missing at this count.

Completeness5/5

The tools cover the full lifecycle of finding, evaluating, and adjusting web data API plans: search for discovery, check_conditions for validation, cost_scenarios for scaling analysis, get_details for deep dives, and relax_conditions for fallback guidance. No obvious gaps exist for the stated purpose.

Available Tools

5 tools
check_conditionsCheck plans against conditionsA
Read-onlyIdempotent
Inspect

Use this when: the user names specific plans (by name, id or pricing-page URL) and wants to know whether they meet the workload and conditions, or which plan of the same product is the cheapest that does. Do not use this when: the user has no plans in mind yet (use search). Check specific plans, given by plan id, plan name or pricing-page URL, against the workload and conditions; up to 20 plans in one call are judged against the same conditions. Returns met / not met / unknown per condition with the official source sentence, which plans and billing options each value applies to, and a purchase link. For each plan it also names the cheapest plan of the same product that meets every required condition, with its monthly cost, or null if none does. An ambiguous name or URL returns the candidate plans instead of a guess.

ParametersJSON Schema
NameRequiredDescriptionDefault
plansNoPlans given by provider and plan name (e.g. "ScrapingBee Freelance") or by pricing-page URL, for plans found elsewhere. A name or URL that fits several plans returns the candidates under resolution and no verdict.
detailNosummary returns one source sentence per fact; full returns every recorded fact and sentence.summary
offer_idsNoPlan ids to check (from search or get_details).
preferredNoNice-to-have conditions; they do not filter, they break ties.
data_regionsNoRegions where data must be stored or processed, e.g. ["EU"]. Different from exit-IP countries.
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 (A fixed-size credit pack bought before use, usually with an expiry.) 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).
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.
min_concurrencyNoMinimum number of concurrent requests (or browsers) the plan must allow.
monthly_searchesNoSearch requests per month (one results page each).
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.
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.
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.
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.
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

ParametersJSON Schema
NameRequiredDescription
as_ofYes
notesYes
requestNo
resultsYes
resolutionNoHow each entry of plans was read.
assumptionsYes
needs_inputYes

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and non-destructive behavior, so the safety profile is covered. The description adds real behavioral context beyond that: a 20-plan batch cap judged against the same conditions, met/not-met/unknown verdicts with the official source sentence, and the notable behavior that an ambiguous name or URL returns candidates rather than guessing. It does not discuss rate limits or cost of the call, which keeps it short of a 5.

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?

Front-loaded with the routing clause, which is exactly what an agent needs first, and the rest is dense with information rather than filler. It is somewhat long and the phrase 'given by plan id, plan name or pricing-page URL' partially restates the opening when-clause, costing a little efficiency.

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

Completeness5/5

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

For a 25-parameter read tool with an output schema, the description covers the routing decision, the batch scope, the verdict semantics, the cheapest-alternative output, and the ambiguity fallback. Nothing an agent needs in order to decide whether and how to call it is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds meaning the schema does not: that plans may be given as provider+name or pricing-page URL and that filtering happens against the same conditions for all plans in a call. The distinction between required and 'preferred' (tie-breaking, non-filtering) is conveyed implicitly through phrasing rather than stated outright.

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 and resource ('Check specific plans ... against the workload and conditions') and explicitly distinguishes itself from the sibling 'search' by scoping the case where the user already has plans in mind. An agent can route between check_conditions and search without opening either schema.

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?

It gives an explicit 'Use this when' clause with the trigger (user names plans by name, id, or pricing-page URL) and an explicit 'Do not use this when' clause pointing at the alternative (use search). This is the textbook when/when-not/alternative pattern.

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

cost_scenariosPlan costs as the workload changesA
Read-onlyIdempotent
Inspect

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 web data 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.

ParametersJSON 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.
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.
data_regionsNoRegions where data must be stored or processed, e.g. ["EU"]. Different from exit-IP countries.
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 (A fixed-size credit pack bought before use, usually with an expiry.) 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).
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.
min_concurrencyNoMinimum number of concurrent requests (or browsers) the plan must allow.
monthly_searchesNoSearch requests per month (one results page each).
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.
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.
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.
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.
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

ParametersJSON Schema
NameRequiredDescription
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.
assumptionsYes
needs_inputYes

TDQS

A4.3/5.0
Behavior4/5

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

Annotations declare readOnly/idempotent/non-destructive, so the safety profile is covered. The description adds real behavioral context beyond that: it returns the cheapest fully matching plan at both ends of the path, each workload where the cheapest plan changes, and step-up/coverage/budget breach points, plus the pricing rules (whole packs, per-period limits, browser billing, minimums). It does not describe pagination or result sizing, but the output richness is well disclosed.

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?

Front-loaded with the when/when-not routing, then the output semantics, then pricing rules; each sentence carries information. It is dense and long, but the length is justified by the tool's complexity and no sentence is redundant filler.

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 27-parameter, nested-object tool with an output schema, the description covers routing, the shape of the path output, and the pricing assumptions that govern the computation. The schema and output schema handle the rest, so it is complete enough to invoke correctly.

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

Parameters3/5

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

Schema description coverage is 100%, so all 27 parameters are already documented; baseline is 3. The description only illustrates scale ('twice the pages or a larger share of JavaScript pages') and the target-vs-scale choice in passing, adding no syntax or format detail the schema lacks.

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

Purpose5/5

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

States a specific verb+resource (shows how web data API plan costs change as workload changes) and immediately scopes it against a named sibling: fixed workload goes to search. An agent can tell this apart from search/check_conditions without opening a schema.

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 'Use this when' (cost changes as workload grows/shifts, or at what volume another plan becomes cheapest) and 'Do not use this when' with the alternative named (search). Both the trigger and the exclusion are stated outright.

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

get_detailsGet recorded conditions of a plan or productA
Read-onlyIdempotent
Inspect

Use this when: you need every recorded condition, pricing rule and source sentence of one plan or product found by search or named by the user. Do not use this when: you want to compare plans against a workload (use search or check_conditions). Get every recorded condition for one plan or product: value, which plans it applies to, exceptions, official source sentence, check date and purchase link. A product too long for one response comes with one source sentence per fact.

ParametersJSON Schema
NameRequiredDescriptionDefault
offer_idNoA plan id, e.g. "firecrawl-standard".
product_idNoA product id, e.g. "firecrawl-api".

Output Schema

ParametersJSON Schema
NameRequiredDescription
as_ofYes
offersYes
productYes
providerYes
evidence_detailNoPresent when the product was too long for one response: each fact carries one source sentence. Ask for a plan by offer_id for every sentence.

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, openWorldHint=false and destructiveHint=false, so the safety profile is covered. The description adds real behavioral context beyond that: what the response contains (value, applicable plans, exceptions, source sentence, check date, purchase link) and the truncation behavior for long products. It could say more about pagination or limits, but this is solid added value.

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?

Front-loaded with the when/not-when decision before the description of contents, which is the right ordering. Three sentences, each earning its place, though the closing sentence about long products is slightly cryptic and the middle sentence is dense with a long enumeration.

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?

An output schema exists, so return-value structure need not be explained, and annotations cover the safety profile; the description nonetheless summarizes the payload and the truncation edge case. Together with routing guidance this is nearly complete, with only minor gaps around result limits or pagination.

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% and the schema itself states 'Give exactly one of offer_id or product_id', so parameter semantics are fully documented structurally. The description only loosely implies single-entity scope ('one plan or product') and adds no syntax or format detail beyond the schema. Baseline 3 is appropriate when the schema does the heavy lifting.

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

Purpose5/5

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

States a specific verb+resource ('get every recorded condition, pricing rule and source sentence of one plan or product') and scopes it to a single entity. It distinguishes itself from siblings check_conditions and search by naming them explicitly. An agent can identify the correct tool without opening the schema.

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?

Provides an explicit 'Use this when' condition (need all recorded conditions of one plan/product found by search or named by user) and a 'Do not use this when' exclusion that routes to search or check_conditions for workload comparison. Both positive and negative cases are covered with named alternatives.

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

relax_conditionsSmallest condition changes that admit plansA
Read-onlyIdempotent
Inspect

Use this when: search finds no plan or too few plans and the user wants to know which condition to loosen and by how much. Do not use this when: plans already match (use search or check_conditions). When no plan, or too few plans, meet every required condition: for each condition the user can change, returns the smallest change that lets at least one plan meet everything (for example the monthly budget needed, the concurrency available, or one exit-IP country to drop) and the plans it admits with their monthly cost. Also lists plans that fail only because a condition is not stated on the official pages, with the pages checked and the check date, so the user can confirm with the provider.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum plans listed for each change and under confirm_with_provider (default 3).
detailNosummary returns one source sentence per fact; full returns every recorded fact and sentence.summary
preferredNoNice-to-have conditions; they do not filter, they break ties.
negotiableNoConditions the user said can change: monthly_volume, concurrency, rate_limit, monthly_budget, billing_type, free_allowance, failed_request_billing, success_billing, target_error_billing, geo_targeting, data_region, serp_response_mode, serp_localization, serp_result_types, serp_engines, crawl_page_limit. Default: every required condition, each marked ask_user because the user has not said it can change.
data_regionsNoRegions where data must be stored or processed, e.g. ["EU"]. Different from exit-IP countries.
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 (A fixed-size credit pack bought before use, usually with an expiry.) 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).
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.
min_concurrencyNoMinimum number of concurrent requests (or browsers) the plan must allow.
monthly_searchesNoSearch requests per month (one results page each).
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.
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.
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.
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.
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

ParametersJSON Schema
NameRequiredDescription
as_ofYes
notesYes
countsYes
changesYes
requestNo
assumptionsYes
needs_inputYes
confirm_with_providerYes

TDQS

A4.5/5.0
Behavior5/5

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

Annotations already declare this a read-only, idempotent, non-destructive, closed-world operation, so the safety profile is covered. The description adds substantive behavior beyond that: it explains that it enumerates a per-condition smallest change, lists admitted plans with their monthly cost, and separately surfaces plans failing only on conditions not stated on official pages along with the pages checked and the check date.

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?

Front-loads the when/use-not structure in two crisp sentences, then explains the return. Slightly long in the closing sentence but every clause describes distinct output content, so little waste.

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?

Given an output schema exists, the description needn't detail returns, yet it usefully explains the confirm-with-provider edge case. It covers when to use, what it yields, and the caveat about unstated conditions; the only gap is that the negotiable-condition semantics are left 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 100% across 26 parameters, so the schema carries the semantic load and 3 is the baseline. The description adds only examples of what a 'change' can be (monthly budget, concurrency, exit-IP country) rather than per-parameter meaning beyond the schema.

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

Purpose5/5

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

States a specific verb and resource ('returns the smallest change that lets at least one plan meet everything') and scopes it precisely to the no-plan / too-few-plans case. An agent can distinguish it from search and check_conditions without opening schemas.

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 'Use this when' and 'Do not use this when: plans already match (use search or check_conditions)' clauses name the alternatives and the selecting condition. Routing is unambiguous.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • Changedrelax_conditions2 fields changed
      • addedOutput schema / properties / changes / items / properties / options / items / properties / admitted / items / properties / meets_all_after_change
        Added value: +{
        +  "description": "Against the request with this change applied: always true, because only plans that then meet every required condition are listed.",
        +  "enum": [
        +    true
        +  ],
        +  "type": "boolean"
        +}
      • changedOutput schema / properties / changes / items / properties / options / items / properties / admitted / items / required
        Previous value: -[
        -  "offer_id",
        -  "offer_name",
        -  "provider_name",
        -  "billing",
        -  "monthly_cost",
        -  "meets_all",
        -  "was",
        -  "facts",
        -  "link"
        -]New value: +[
        +  "offer_id",
        +  "offer_name",
        +  "provider_name",
        +  "billing",
        +  "monthly_cost",
        +  "meets_all",
        +  "meets_all_after_change",
        +  "was",
        +  "facts",
        +  "link"
        +]
  2. 5 tool updates
    • First observedcheck_conditions
    • First observedcost_scenarios
    • First observedget_details
    • First observedrelax_conditions
    • First observedsearch

Related MCP Connectors

Related MCP Servers

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources