Skip to main content
Glama
Sign In

ProofPrice

by com.proofprice
OverviewDiscussionsAdmin

What price data is covered

pricepaid_coverage
Read-onlyIdempotent

Use this to see which countries and kinds of price the tools cover. It returns a short overview: for each tool the countries it answers for, how many official sources stand behind it and how often they update. Give category and/or country to get the full detail of the matching sources instead (publisher, licence, attribution line, limits, example requests). Every source at once, as JSON: https://proofprice.com/api/v1/coverage

Input Schema

NameRequiredDescriptionDefault
countryNoOptional. Return the full detail of the sources that cover this country: an ISO code such as IE, GB or FR. Can be combined with category.
categoryNoOptional. Return the full detail of this category's sources: one of border-prices, broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, state-property-rents, supplementary-health-insurance, surplus-auctions, transport-fares, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works).

Output Schema

NameRequiredDescriptionDefault
rulesNo
toolsYes
detailYessummary = the short overview (the default); full = every matching source in full, for the category and/or country asked for.
filterNoThe slice asked for (detail full only).
purposeNo
serviceYes
sourcesNoDetail full only: each matching source with its publisher, licence, attribution line, update frequency and limits.
summaryYesOne plain sentence an AI can quote, with how to get more detail.
examplesNoDetail full only: working example requests (REST paths) for the matching sources.
coming_nextNo
source_countYesHow many sources the answer covers: all of them in the overview, the matching ones in a slice.
full_coverage_urlYesEvery source at once, as JSON (REST).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of border-prices, broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, surplus-auctions, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of border-prices, broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, state-property-rents, supplementary-health-insurance, surplus-auctions, transport-fares, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."
  2. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, surplus-auctions, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of border-prices, broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, surplus-auctions, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."
  3. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, health-insurance, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, surplus-auctions, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."
  4. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-markets, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works)."
  5. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-markets, wholesale-power (the tool name also works)."
  6. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-power (the tool name also works)."
  7. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."
  8. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."
  9. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."
  10. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition, wholesale-power (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, insurance, land-prices, medical, medicines, producer-prices, rent, tuition, wholesale-power (the tool name also works)."
  11. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition, wholesale-power (the tool name also works)."
  12. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, construction, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition (the tool name also works)."
  13. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent, tuition (the tool name also works)."
  14. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, land-prices, medical, medicines, rent (the tool name also works)."New value: +"Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, land-prices, medical, medicines, rent (the tool name also works)."
  15. Changed17 schema fields changed
    • addedInput schema / properties / category
      Added value: +{
+  "description": "Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, contracts, energy, farm-prices, flights, fuel, groceries, home-sales, land-prices, medical, medicines, rent (the tool name also works).",
+  "type": "string"
+}
    • addedInput schema / properties / country
      Added value: +{
+  "description": "Optional. Return the full detail of the sources that cover this country: an ISO code such as IE, GB or FR. Can be combined with category.",
+  "type": "string"
+}
    • changedOutput schema / description
      Previous value: -"Which tools, countries and official sources are covered, with each source's licence and update frequency."New value: +"Which price tools, countries and official sources are covered: a short overview by default, or full per-source detail (licence, attribution, limits) for a category and/or country."
    • addedOutput schema / properties / detail
      Added value: +{
+  "description": "summary = the short overview (the default); full = every matching source in full, for the category and/or country asked for.",
+  "enum": [
+    "summary",
+    "full"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / examples / description
      Added value: +"Detail full only: working example requests (REST paths) for the matching sources."
    • addedOutput schema / properties / filter
      Added value: +{
+  "additionalProperties": {},
+  "description": "The slice asked for (detail full only).",
+  "properties": {
+    "category": {
+      "type": "string"
+    },
+    "country": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}
    • addedOutput schema / properties / full_coverage_url
      Added value: +{
+  "description": "Every source at once, as JSON (REST).",
+  "type": "string"
+}
    • addedOutput schema / properties / source_count
      Added value: +{
+  "description": "How many sources the answer covers: all of them in the overview, the matching ones in a slice.",
+  "type": "number"
+}
    • addedOutput schema / properties / sources / description
      Added value: +"Detail full only: each matching source with its publisher, licence, attribution line, update frequency and limits."
    • addedOutput schema / properties / summary
      Added value: +{
+  "description": "One plain sentence an AI can quote, with how to get more detail.",
+  "type": "string"
+}
    • addedOutput schema / properties / tools / items / properties / category
      Added value: +{
+  "description": "The category id, to pass as category for a slice.",
+  "type": "string"
+}
    • addedOutput schema / properties / tools / items / properties / countries / description
      Added value: +"ISO country codes the tool answers for."
    • addedOutput schema / properties / tools / items / properties / name / description
      Added value: +"The MCP tool to call for this kind of price."
    • addedOutput schema / properties / tools / items / properties / source_count
      Added value: +{
+  "type": "number"
+}
    • addedOutput schema / properties / tools / items / properties / update_frequency
      Added value: +{
+  "description": "How often the official sources behind this tool update; several sources are separated by ' | '.",
+  "type": "string"
+}
    • changedOutput schema / properties / tools / items / required
      Previous value: -[
-  "name",
-  "rest",
-  "countries"
-]New value: +[
+  "name",
+  "category",
+  "rest",
+  "countries",
+  "source_count",
+  "update_frequency"
+]
    • changedOutput schema / required
      Previous value: -[
-  "service",
-  "tools",
-  "sources"
-]New value: +[
+  "service",
+  "detail",
+  "summary",
+  "full_coverage_url",
+  "source_count",
+  "tools"
+]
  16. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": {},
+  "description": "Which tools, countries and official sources are covered, with each source's licence and update frequency.",
+  "properties": {
+    "coming_next": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "examples": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "purpose": {
+      "type": "string"
+    },
+    "rules": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "service": {
+      "type": "string"
+    },
+    "sources": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "licence": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "publisher": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "publisher",
+          "licence"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "tools": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "countries": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "name": {
+            "type": "string"
+          },
+          "rest": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "rest",
+          "countries"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "service",
+    "tools",
+    "sources"
+  ],
+  "type": "object"
+}
  17. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already cover readOnly, idempotent, openWorld. The description adds real behavioral detail: what the overview contains (countries per tool, number of official sources, update frequency) and what the detail mode contains (publisher, licence, attribution line, limits, example requests). The trailing bulk-JSON endpoint sentence is useful but slightly unclear in intent.

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 purpose, then the default output, then the parameter-driven alternative. Only the final bare URL sentence feels unintegrated and slightly ambiguous, keeping it from a 5.

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

Completeness4/5

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

With an output schema present the description needn't define return shapes, yet it still characterizes both output modes well enough for an agent to pick the right call. Only the bulk-JSON URL mention is left unexplained.

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. The description goes beyond the schema by tying the parameters to a mode switch — passing country and/or category changes the result from a summary to full source records — which the schema's per-parameter text only implies.

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 states a specific function: a coverage/discovery tool showing which countries and kinds of price the other tools cover. That is clearly distinguishable from every sibling, all of which return actual price data. The two modes (overview vs. source detail) are named up front.

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

Usage Guidelines4/5

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

It gives a clear default behavior ('It returns a short overview') and an explicit trigger for the alternative mode ('Give category and/or country to get the full detail'). It doesn't spell out when not to use this tool or point at a sibling for a related need, but the context is clear enough.

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

All ProofPrice toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources