Endpoints: 76,849MCP servers: 32,725Payout addresses: 3,825Paid calls: 6,134Letters: 84Defects: 3,890counted 3 min ago
teppi

Server definition

Hash
sha256:4ea49c611e13a18c3428dc254ba1d0ecf3ddae497c2474ceaa4ee2ebce70a8bc
What it is
What a remote MCP server returned when asked what it offers: 14 tools

The blob, as servednamed by its sha256

{ "instructions": "BusinessRateChecker: business rates data for England and Wales from the Valuation Office (the 2026 rating list in force, with each property's rateable value on the 2023 list and, in England, the 2017 list, where it existed then), plus our comparable-evidence verdict on whether a property looks overpaid.\n\nHow to use the tools:\n- How to answer: answer the user's question from the tool data, as a rating adviser would. Do not add commentary about BusinessRateChecker itself - the connector, its engine, its data coverage, or how the product could be improved - and do not tell users to open or buy a report on the website: everything this service knows about a property is available through these tools (get_property, get_overpayment_verdict, get_comparables, get_rating_history), so fetch more detail with them instead. get_overpayment_verdict carries the full report's own sections: grounds (every finding, strongest first, with its evidence), checks (rateable value, floor area against the energy certificate, allowances, reliefs), route (Check, then Challenge, then Tribunal, or a self-check when nothing is flagged) and next_steps; relay them rather than summarising them away. It also carries relief_view (England and Wales): the bill after small business relief (England: Small Business Rate Relief, one property, 100% to £12,000 tapering to nothing at £15,000; Wales: small business rates relief, no more than two properties in the council, 100% to £6,000 tapering to nothing at £12,000), the saving after relief (for a sole_property=true occupier, the same figure as indicative_saving.annual_if_sole_property), what £100 off the rateable value is worth inside the taper, and what_ifs / outcomes. In Wales these are full-year figures; when relief_view.basis_note is set, transitional relief limits this year's saving (see indicative_saving.transitional_relief) and you should say so. What-ifs are illustrations, never findings, so always give relief_view.caveat with them and never present one as a saving we found. get_comparables lists each comparable's allowances. Citing the free public sources named below (the overpayment map, published tribunal decisions) is fine.\n- One engine (from 13 Oct 2026): every verdict, saving, comparable and screening result, in England and Wales, comes from the same engine as the website report and the overpayment map. Verdicts are exactly the website's: outcome is one of strong_case (\"Strong case\"), worth_checking (\"Worth checking\"), no_obvious_issues (\"No obvious issues\"), not_enough_evidence (\"Not enough evidence\") or needs_turnover (\"Needs your turnover\"), with the website's wording in label; flagged is true for strong_case or worth_checking, the test the overpayment map counts. A £ figure is given exactly when the website shows one: always for strong_case, sometimes for worth_checking (worth_checking without a figure means signs worth checking but no reliable amount). not_enough_evidence is not a clean bill of health and not a reason to act: say there is too little comparable evidence to judge. Use the label wording when you relay a verdict.\n- get_overpayment_map is free and needs no sign-in: the published overpayment map figures (flagged properties, % flagged, median claim, national indicative saving) for England and Wales, England, Wales, or a council with its rank. Use it for \"how many businesses overpay\", \"which councils are worst\", \"how does Leeds compare\". Quote the figures as flagged by our checks, not proven overpayments; properties at or below the small business rate relief level count one third. Cite https://businessratechecker.com/intelligence/map. Its win_rates are the VOA's own Official Statistics (refused cases counted), not our engine: quote win_rate_pct with resolved, say which rating list, and treat low_volume rates with caution; the 2026 list is too new for reliable rates.\n- Wales (from 12 Oct 2026): find_properties, get_property, get_overpayment_verdict, get_comparables and get_rating_history also answer for Welsh properties; their responses carry country \"W\" and use the Welsh multipliers (35.0p retail up to £51,000, 50.2p standard, 51.5p over £100,000), Welsh small business rates relief (100% to £6,000 tapering to £12,000, up to two properties per council) and Welsh transitional relief (on a rise of more than £300, 33% of the rise paid in 2026/27, 66% in 2027/28). For Welsh rules call explain_business_rates with country wales. search_properties and area_breakdown also answer for a Welsh council (name or ba_code), a full Welsh postcode, or a postcode district with no English properties; in a district that crosses the border (e.g. LD7, HR3, CH4, NP16, SY10) they answer for England, so use the Welsh council for the Welsh side. Welsh screening savings are before Welsh small business rates relief and transitional relief. The monthly statistics (get_area_statistics, get_sector_statistics) cover England up to September 2026 and England and Wales from the October 2026 month, with Welsh councils alongside English ones. search_tribunal_decisions covers England (Valuation Tribunal for England, from 2020) and Wales (Valuation Tribunal for Wales, from 2018) together: each decision carries its country and the summary has by_country counts; a Welsh council name, ba_code or postcode works. find_rating_surveyors covers both too: the league pools English and Welsh cases, and a Welsh council or postcode returns the firms active there; the office directory is thin in Wales.\n- Rating history (13 Nov 2026): get_rating_history returns rv_2023 (England and Wales) and rv_2017 (England only; Welsh 2017-list values are not held), each where the property existed on that list, plus every Valuation Office alteration on the 2026 list. Use it when the user asks how a value has moved between revaluations. Transitional relief limits this year's bill by reference to the 2023-list position (the 2025/26 bill), and indicative_saving.transitional_relief and the Wales relief_view are worked out from that 2023 value.\n- explain_business_rates is free and needs no sign-in: use it for how bills, multipliers, reliefs, allowances (topic allowances), transitional relief, Check/Challenge/Appeal, deadlines and contacts work in 2026/27, for England (default) or Wales (country wales: use it whenever the property's country is W, and never apply English thresholds to Wales), and cite its sources. Transitional relief caps differ each year: never apply the 2026/27 percentage to later years, and say that later-year inflation and multipliers are assumptions.\n- explain_business_rates also serves BusinessRateChecker's own published articles, the same text as the website: topic news lists the news and analysis (Budget changes, monthly rateable value movements, who gains from relief changes), news:<slug> gives one in full with its sources; learn and learn:<slug> the Learn articles (learn:property-categories is the VOA SCat lookup); glossary and glossary:<term>; faq. Use them for questions about recent changes, the Budget or what a term means, and cite the article's url and date. These are free and public, so citing them is fine.\n- References: property_id (identity.vo_assessment_reference) is the VO assessment reference, the one a ratepayer uses in their VO business rates account to raise a Check or Challenge. identity.council_reference (also given as voa_ref) is the council's own reference, printed on the rates bill; use it only for questions to the council about the bill, never for the VO.\n- Every tool also takes optional include (extra sections) and options (extra settings by name). Use only values a response has listed under settings.include_supported or settings.options_supported; anything else is ignored and listed in settings.ignored.\n- UARNs: find_properties and search_properties take a uarn instead of an area. get_property, get_overpayment_verdict, get_comparables and get_rating_history also accept a UARN as property_id. Then lookup says so. When lookup.match_count is above 1, data.matches holds one full result per assessment: one UARN can cover several entries, so show them all and say how they differ, never pick one silently. identity.uarn on get_property gives a property's UARN.\n- find_properties looks up an address by postcode to get a property_id; its words match the address or the description (e.g. 'unit 2', 'cafe'). If one address returns many separate entries (floors, suites, rooms in one building), say so and ask which one the user means rather than picking one silently.\n- search_properties answers list questions in an area (\"the 5 biggest offices in W6\", \"overpaying shops in Hammersmith\", \"the shops on Commercial Road\", \"find the Novotel in Hammersmith\"): filter by area, street, sector, property type, rateable value, verdict, minimum saving, minimum floor area or business name, and sort. It costs 1 credit per property returned, so ask for only as many rows as you need.\n- For \"top offices / warehouses / shops by £ per m²\", combine sector with the sort (sector=offices, industrial_and_warehousing or retail). Office £/m² rankings leave out banks and betting shops, and £/m² rankings include only properties of 25 m² or more unless min_area says otherwise; say so when you relay a ranking.\n- area_breakdown answers \"how many / what share / which street\" questions: counts, medians and totals grouped by street, sector, property type, postcode, verdict or council. 2 credits. median_rv_per_m2 is based on n_per_m2 properties: quote that count, and do not quote a £/m² median where n_per_m2 is small or zero.\n- Every search needs an area (postcode, district, sector or council). National lists are not offered.\n- For £ per m², counts or overpaid shares across an area or council (e.g. \"compare office £/m² in Manchester and Leeds\"), use area_breakdown with group_by sector, one call per area. get_area_statistics and get_sector_statistics are ONLY about the properties the VO amended in one month; never present one month as a trend, and if 'rankable' is false do not rank that place against others.\n- Beach huts, car parking spaces, moorings, advertising panels and similar are valued per unit, not per m²: they have no £/m² and are not compared on it. Hotels, pubs, cinemas and petrol stations are valued on trading potential: never compare them on £/m² (see valuation_basis on get_property).\n- get_overpayment_verdict and get_comparables include a scheme_check: how the VO's own valuation scheme values similar-sized properties. When the subject sits at, within or below its scheme's range, or the explanation says the comparables are mostly in other schemes, say plainly that a challenge on rate alone is weak, even if the verdict shows a saving.\n- search_properties and area_breakdown give the same verdicts and figures as the website's property reports; for the explanation behind one property's verdict call get_overpayment_verdict.\n- get_overpayment_verdict is the main answer. When you relay it, ALWAYS include its \"hedge\" text: the verdict is an indicative estimate from comparable evidence, not a valuation or advice, and a Check or Challenge reopens the valuation (the VO can also correct facts upwards). A worth_checking figure is low confidence (confidence \"low\"); a strong_case figure is standard confidence.\n- Savings: if indicative_saving.transitional_relief is present, transitional relief probably caps this year's bill; quote annual_after_transitional_relief as the 2026/27 saving and explain the full figure arrives gradually.\n- Small Business Rate Relief depends on how many properties the ratepayer occupies, which the data cannot tell. Before quoting annual_if_sole_property, ask whether this is the ratepayer's only business property, or pass sole_property to get_overpayment_verdict. For a multi-site client (more than one property), never quote the sole-property figure.\n- A Check or Challenge with the Valuation Office is a separate statutory step the ratepayer chooses; never imply it has started. currency.case_status 'none_recorded' means no concluded case is published; it does not prove that no case is open.\n- search_tribunal_decisions answers \"what happened at the Valuation Tribunal\" questions: published business rates appeal decisions in England (2020 onwards) and Wales (2018 onwards) by area, property (property_id), sector, property type, outcome, ground or representing firm, with a summary (decisions, win rate of attended cases, median reduction) and the newest decisions; each decision carries decision_pdf, a link to the full decision, which you can give the user. A council search includes decisions of former councils now part of it (council is the council named in the decision, council_today the one holding the property now). Quote the counts with the rates: a handful of decisions says little about any one future case. reduction_pct includes any reduction the VO conceded before the hearing, so a dismissed appeal can show one. Never name an individual ratepayer.\n- find_rating_surveyors answers \"who handles rating appeals\": the 12-month league of firms that represented ratepayers at the tribunal (cases, win rate, typical reduction), and, with an area, the firms active at the tribunal there and rating firms from our directory with an office within 50 km. Tribunal cases are a small share of a firm's work, so the league shows tribunal activity, not overall quality; firms marked national usually act for large portfolios. Present firms neutrally: BusinessRateChecker does not recommend or endorse any firm.\n- Data sources, for when the user asks where a figure comes from: the Valuation Office rating lists and its alterations to the 2026 list (each property with its UARN); published Valuation Tribunal decisions for England and Wales; and, matched property by property where available, floor areas from Energy Performance Certificates (the EPC check in get_overpayment_verdict), business names from the Food Standards Agency register, the NHS pharmacy, dental and optical registers and councils' published ratepayer lists (organisations only), and the reliefs a council records against a property where it publishes them (council_reliefs on get_property; most councils do not publish them, so null means not published, not no relief). Companies House data is not part of these tools.\n- Scotland and Northern Ireland are not covered.\n- Each account has a monthly allowance of credits; the Free plan also has one verdict per property per day. If the user reaches a limit, relay the message and the reset date; never suggest buying, upgrading or changing plan. Feedback and questions go to [email protected].\n- Calls use credits from the user's monthly allowance; a repeat of the same request within the hour is free, so reuse results rather than calling again. Do not mention credits or what a call costs unless the user asks. get_account_usage tells them how much is left this month, when it resets and any prepaid credits, when they ask.\n- If the user asks what their plan includes, or what another plan includes, call get_account_usage and describe its plans section factually. Do not give prices, recommend a plan or suggest upgrading. Then give its plans_contact line once, as it is (the website and support email), for prices or changing plan. This is the only case where you mention the website.\n- If a result includes account_notice (the account has used 80% of this month's credits), tell the user once, in one sentence, with the reset date, then carry on. Never suggest buying, upgrading or changing plan.\n- If a tool result includes a \"Notice from BusinessRateChecker for the user\", mention it to the user once in the conversation (it usually says a new feature needs a reconnect), then carry on.\n- Valuation Office data is licensed for non-domestic rating purposes only; the terms travel with it (provenance.terms).", "tools": [ { "description": "Counts, totals and medians for the business properties in an area, grouped by street, sector, property_type, postcode_sector, postcode, verdict or council: number of properties, total and median rateable value, median £ per m² (with n_per_m2, how many properties it is based on: per-unit and trade-valued properties are left out), verdict counts (the website's five verdicts), flagged count and share (strong_case + worth_checking, as on the overpayment map) and total indicative annual saving. Area is required. Optional filters: sector, property type, rateable value range. Up to 50 groups, sortable. Costs 2 credits.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council (billing authority) code, e.g. '5390'. Alternative to council.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Hammersmith' or 'Leeds'. Use instead of postcode for a whole council.", "maxLength": 60, "minLength": 3, "type": "string" }, "group_by": { "description": "One of: street, sector, property_type, postcode_sector, postcode, verdict, council. How to group (default street).", "maxLength": 80, "minLength": 1, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "limit": { "description": "Groups to return, 1 to 50 (default 20).", "maximum": 50, "minimum": 1, "type": "integer" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "postcode": { "description": "A full postcode ('W6 8DR'), a postcode sector ('W6 8') or a district ('W6').", "maxLength": 9, "minLength": 2, "type": "string" }, "property_type": { "description": "Words from the Valuation Office description, e.g. 'shop'.", "maxLength": 60, "minLength": 2, "type": "string" }, "rv_max": { "description": "Maximum rateable value in pounds.", "maximum": 100000000, "minimum": 0, "type": "number" }, "rv_min": { "description": "Minimum rateable value in pounds.", "maximum": 100000000, "minimum": 0, "type": "number" }, "sector": { "description": "One of: car_parking_and_storage, healthcare, industrial_and_warehousing, leisure_and_hospitality, offices, other_specialist, retail. ", "maxLength": 80, "minLength": 1, "type": "string" }, "sort": { "description": "One of: properties_desc, total_rv_desc, total_saving_desc, flagged_desc, flagged_share_desc, median_rv_per_m2_desc. Default properties_desc. flagged_desc / flagged_share_desc rank by strong_case + worth_checking.", "maxLength": 80, "minLength": 1, "type": "string" } }, "type": "object" }, "name": "area_breakdown", "outputSchema": null }, { "description": "Free, no sign-in. Plain-English reference for 2026/27 with official sources, for England (default) or Wales (country: wales): how a bill is worked out, the multipliers, small business rate relief, retail/hospitality/leisure (England) or food and drink hospitality relief (Wales), pubs, charitable, rural and empty property relief, transitional relief, allowances, how a Check, Challenge and Appeal work, the deadlines, and who to contact. The two countries have different topic lists: omit topic to list them for the chosen country. Also BusinessRateChecker's published news and analysis (topic news, then news:<slug>), Learn articles (learn, learn:<slug>), glossary (glossary, glossary:<term>) and FAQ (faq), the same text as the website.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "country": { "description": "england (default) or wales. Use wales for a property whose country is W.", "maxLength": 80, "minLength": 1, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "topic": { "description": "One of: overview, multipliers, small_business_rate_relief, retail_hospitality_leisure, pubs_and_live_music, charitable_relief, rural_relief, empty_property, transitional_relief, check_challenge_appeal, allowances, deadlines, contacts, wales, food_and_drink_hospitality, all, news, learn, glossary, faq. A topic id, or 'all'; news, learn and glossary list their items, then ask for one as news:<slug>, learn:<slug> or glossary:<term>. Omit to list the topics for the chosen country.", "maxLength": 80, "minLength": 1, "type": "string" } }, "type": "object" }, "name": "explain_business_rates", "outputSchema": null }, { "description": "Search the 2026 rating list for England and Wales. Give a full postcode (e.g. 'WR3 8TJ') or an outward code (e.g. 'WR3'), optionally narrowed by words from the address or the description (e.g. 'unit 96a', 'cafe'), or a council's ba_code. Returns up to 20 properties with property_id, address, description, rateable value and business name where known. One building can hold many separate entries (floors, suites): ask which one if that matters. Use the property_id with the other tools. Costs 1 credit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council (billing authority) code, e.g. '1835' for Worcester. Use instead of postcode.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "limit": { "description": "Number of results, 1 to 20 (default 20).", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "postcode": { "description": "Full postcode or outward code, e.g. 'BD13 3EL' or 'BD13'.", "maxLength": 9, "minLength": 2, "type": "string" }, "query": { "description": "Words from the address or the VO description to narrow the results, e.g. 'unit 2' or 'cafe'.", "maxLength": 100, "type": "string" }, "uarn": { "description": "A UARN, instead of postcode or ba_code: returns every current entry it covers, England and Wales.", "pattern": "^[0-9]{4,15}$", "type": "string" } }, "type": "object" }, "name": "find_properties", "outputSchema": null }, { "description": "Which surveying firms represent ratepayers in business rates appeals. Returns the 12-month league of firms at the Valuation Tribunals for England and Wales (cases, attended, won, win rate, typical reduction, councils, latest decision, website), or the firms matching a name. With an area (postcode or council) it also returns the firms that represented ratepayers at the tribunal there in the same 12 months, and rating firms from our directory with an office within 50 km (firm, size, nearest office, distance, website). Firms only; no individual is named. BusinessRateChecker does not recommend or endorse any firm. Costs 1 credit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council (billing authority) code, e.g. '5390'. Alternative to council.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Hammersmith' or 'Leeds'. Use instead of postcode for a whole council.", "maxLength": 60, "minLength": 3, "type": "string" }, "firm": { "description": "A firm's name or part of it, e.g. 'Knight Frank'.", "maxLength": 60, "minLength": 2, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "limit": { "description": "Rows for the area lists and firm matches, 1 to 25 (default 10).", "maximum": 25, "minimum": 1, "type": "integer" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "postcode": { "description": "A full postcode ('W6 8DR'), a postcode sector ('W6 8') or a district ('W6').", "maxLength": 9, "minLength": 2, "type": "string" } }, "type": "object" }, "name": "find_rating_surveyors", "outputSchema": null }, { "description": "How much of the user's monthly credit allowance is left: allowance, used, % used, remaining, the date it resets, and any prepaid credits with their expiry dates (used after the monthly allowance, oldest first). Shared across everyone on the same company plan. Also lists what the Free, Professional and Professional Plus plans each include (your_plan marks theirs). Use only when the user asks how much they have left, when they will reset, or what their plan or another plan includes. Free.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" } }, "type": "object" }, "name": "get_account_usage", "outputSchema": null }, { "description": "How the rateable values the Valuation Office AMENDED in one month moved, for one council (billing authority) by name or code, or a short list of every council (name, code, number amended, % change) if neither is given. Covers only the properties amended that month, not the whole council, and one month is never a trend: call it for several months to see a direction. Always read pct_change with n_amended, top1_share_pct and median_mover_pct; pct_change is null when not publishable, and rankable=false means do not rank the place against others. For £ per m², property counts or overpaid shares across a council, use area_breakdown instead. Costs 1 credit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council code, e.g. '1835'. Alternative to council.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Birmingham'.", "maxLength": 60, "minLength": 3, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "month": { "description": "Month as YYYY-MM. Omit for the latest complete month.", "pattern": "^\\d{4}-\\d{2}$", "type": "string" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" } }, "type": "object" }, "name": "get_area_statistics", "outputSchema": null }, { "description": "The comparable properties behind the verdict, with their rate per square metre, distance, allowances, business names (shopfront and ratepayer, where published) and valuation lines (floor, use, area, rate, value) - so no separate get_property call is needed for each comparable - a plain account of how they were found (search.method, nearest_km, furthest_km, same_scheme_count), and a scheme_check: how the VO's own valuation scheme values similar-sized properties and whether the subject sits below, within or above that range. Costs 5 credits.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "property_id": { "description": "The property_id from find_properties (the Valuation Office assessment reference), or a UARN, 4 to 15 digits. A UARN that covers several entries returns them all.", "pattern": "^[0-9]{4,15}$", "type": "string" } }, "required": [ "property_id" ], "type": "object" }, "name": "get_comparables", "outputSchema": null }, { "description": "Free, no sign-in. The figures on BusinessRateChecker's overpayment map for England and Wales (2026 rating lists): properties analysed, properties flagged by our checks as paying too much, % flagged, '1 in N', median annual claim per flagged property, and the national indicative saving a year. With no area: England and Wales, England and Wales separately, and the 10 councils with the highest and lowest % flagged (country narrows these to England or Wales). With council or ba_code: up to 10 matching councils, each with its rank out of 318 (and within its country). Properties at or below the small business rate relief level (rateable value 12,000 GBP England, 6,000 GBP Wales) count one third. Same figures as https://businessratechecker.com/intelligence/map and its CSV. Each council and national block also carries win_rates: the Valuation Office's own statistics on how many resolved Checks and Challenges cut the rateable value, per rating list (2017 England only, 2023, 2026).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "VO billing-authority code (e.g. '4720') or ONS code (e.g. 'E08000035').", "pattern": "^([0-9A-Za-z]{4}|[EWew]0[6-9][0-9]{6})$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Leeds' or 'Cardiff'.", "maxLength": 60, "minLength": 3, "type": "string" }, "country": { "description": "england or wales. Rank councils within England or Wales only. Omit for both.", "maxLength": 80, "minLength": 1, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" } }, "type": "object" }, "name": "get_overpayment_map", "outputSchema": null }, { "description": "BusinessRateChecker's verdict on whether a property's rateable value looks high against comparable properties, exactly as on the website report: strong_case, worth_checking, no_obvious_issues, not_enough_evidence or needs_turnover (with the website's wording in label, and flagged as on the overpayment map), with a suggested rateable value and indicative annual saving where there is one (and, where transitional relief probably caps this year's bill, the saving after it), the confidence, the hedge text that must be relayed with any figure, and a scheme_check showing how the VO's own valuation scheme values similar-sized properties (a saving on a property that sits within its scheme's range is a weak case on rate alone). Pass sole_property=false for a ratepayer with other business properties (Small Business Rate Relief then does not apply) or true if this is their only one. Also carries everything the full report sets out: grounds (every finding with its evidence), checks (rateable value, floor area, allowances, reliefs), route (Check, Challenge, Tribunal) and next_steps. Same engine as the website report. Costs 5 credits (one verdict per property per day).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "property_id": { "description": "The property_id from find_properties (the Valuation Office assessment reference), or a UARN, 4 to 15 digits. A UARN that covers several entries returns them all.", "pattern": "^[0-9]{4,15}$", "type": "string" }, "sole_property": { "anyOf": [ { "type": "boolean" }, { "enum": [ "true", "false" ], "type": "string" } ], "description": "true if this is the ratepayer's only business property, false if they occupy others. Omit if unknown, then ask before quoting the Small Business Rate Relief figure." } }, "required": [ "property_id" ], "type": "object" }, "name": "get_overpayment_verdict", "outputSchema": null }, { "description": "The full rating-list entry for one property: address, description, rateable value, how it is valued (valuation_basis: floor area, Zone A, per unit, or trade for hotels and pubs), floor area and valuation lines, estimated 2026/27 bill before reliefs, Small Business Rate Relief status, and whether the Valuation Office has changed it (currency, with case_status). Costs 1 credit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "property_id": { "description": "The property_id from find_properties (the Valuation Office assessment reference), or a UARN, 4 to 15 digits. A UARN that covers several entries returns them all.", "pattern": "^[0-9]{4,15}$", "type": "string" } }, "required": [ "property_id" ], "type": "object" }, "name": "get_property", "outputSchema": null }, { "description": "How a property's rateable value has changed: its value on the 2023 list (England and Wales) and the 2017 list (England), where held, and Valuation Office alterations on the 2026 list, including Check and Challenge outcomes. Costs 2 credits.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "property_id": { "description": "The property_id from find_properties (the Valuation Office assessment reference), or a UARN, 4 to 15 digits. A UARN that covers several entries returns them all.", "pattern": "^[0-9]{4,15}$", "type": "string" } }, "required": [ "property_id" ], "type": "object" }, "name": "get_rating_history", "outputSchema": null }, { "description": "How the rateable values the Valuation Office AMENDED in one month moved across England (and Wales, from the October 2026 month), for one broad sector (industry, offices, retail or other, the VO's own grouping). Covers only the properties amended that month. Read pct_change with n_amended and median_mover_pct. For £ per m² or overpaid shares, use area_breakdown with group_by sector for an area. Costs 1 credit.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "month": { "description": "Month as YYYY-MM. Omit for the latest complete month.", "pattern": "^\\d{4}-\\d{2}$", "type": "string" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "sector": { "description": "One of: industry, offices, retail, other.", "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "sector" ], "type": "object" }, "name": "get_sector_statistics", "outputSchema": null }, { "description": "List business properties in an area that match filters, sorted the way the question asks. Area is required (postcode, sector, district or council). Filters: street, sector, property type words (e.g. 'shop', 'office', 'warehouse', 'hotel'), business or building name (e.g. 'Novotel'), rateable value range, verdict, minimum indicative annual saving, minimum floor area. Sorts: rateable value, saving, floor area, or rateable value per square metre (per-m² rankings use only properties of 25 m² or more by default, and office rankings leave out banks and betting shops). Returns up to 50 rows with property_id, address, names, use, rateable value, floor area and £ per m² (the main use's, the same figures as the verdict; total_floor_area_m2 is the whole property, and floor-area filters and sorts use the main-use area), rate_basis and the verdict (the same as the website report, with label and flagged) and saving (before small business rate relief and transitional relief). Costs 1 credit per property returned (minimum 1); results stop 250 rows deep.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council (billing authority) code, e.g. '5390'. Alternative to council.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Hammersmith' or 'Leeds'. Use instead of postcode for a whole council.", "maxLength": 60, "minLength": 3, "type": "string" }, "cursor": { "description": "next_cursor from a previous call, for the next page.", "maxLength": 200, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "limit": { "description": "Rows to return, 1 to 50 (default 10). Each row costs 1 credit.", "maximum": 50, "minimum": 1, "type": "integer" }, "min_area": { "description": "Only properties of at least this many m². Default 25 for £ per m² sorts; 0 switches the default off.", "maximum": 1000000, "minimum": 0, "type": "number" }, "min_saving": { "description": "Only properties whose indicative annual saving is at least this many pounds.", "maximum": 100000000, "minimum": 0, "type": "number" }, "name": { "description": "Business or building name, or address words, e.g. 'Novotel'.", "maxLength": 80, "minLength": 2, "type": "string" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "postcode": { "description": "A full postcode ('W6 8DR'), a postcode sector ('W6 8') or a district ('W6').", "maxLength": 9, "minLength": 2, "type": "string" }, "property_type": { "description": "Words from the Valuation Office description, e.g. 'shop', 'office', 'warehouse', 'hotel', 'restaurant'. 'warehouse' does not include retail warehouses unless sector is retail.", "maxLength": 60, "minLength": 2, "type": "string" }, "rv_max": { "description": "Maximum rateable value in pounds.", "maximum": 100000000, "minimum": 0, "type": "number" }, "rv_min": { "description": "Minimum rateable value in pounds.", "maximum": 100000000, "minimum": 0, "type": "number" }, "sector": { "description": "One of: car_parking_and_storage, healthcare, industrial_and_warehousing, leisure_and_hospitality, offices, other_specialist, retail. Broad sector. Use it with £ per m² sorts so the ranking compares like with like.", "maxLength": 80, "minLength": 1, "type": "string" }, "sort": { "description": "One of: rateable_value_desc, rateable_value_asc, saving_desc, floor_area_desc, rate_per_m2_desc, rate_per_m2_asc, transitional_relief_desc, rv_rise_pct_desc, rv_rise_desc. Default rateable_value_desc. rate_per_m2_* only ranks properties measured in square metres.", "maxLength": 80, "minLength": 1, "type": "string" }, "street": { "description": "Street name, e.g. 'Commercial Road'. Matches the start of the street.", "maxLength": 80, "minLength": 2, "type": "string" }, "uarn": { "description": "A UARN, instead of an area: the entries it covers, with their verdicts. The other filters still apply.", "pattern": "^[0-9]{4,15}$", "type": "string" }, "verdicts": { "description": "One of: strong_case, worth_checking, no_obvious_issues, not_enough_evidence, needs_turnover. Only these verdicts (the website's): strong_case, worth_checking, no_obvious_issues, not_enough_evidence, needs_turnover; e.g. ['strong_case', 'worth_checking'] for flagged properties. (Older words are still accepted and translated.)", "items": { "maxLength": 80, "minLength": 1, "type": "string" }, "maxItems": 5, "minItems": 1, "type": "array" } }, "type": "object" }, "name": "search_properties", "outputSchema": null }, { "description": "Published decisions of the Valuation Tribunal for England (about 3,300, 2020 onwards) and the Valuation Tribunal for Wales (about 1,400, 2018 onwards) on business rates appeals; each decision carries its country. Filter by area (postcode or council, English or Welsh), a property (property_id from find_properties), sector, property type words, outcome (won or lost), the decisive ground, the firm that represented the ratepayer, rating list year and decision date. Returns a summary over every match (decisions, attended, won, win rate of attended cases, cases reduced, median reduction %, rateable value removed, the commonest decisive grounds) and the newest decisions with the original, proposed, VO-conceded and tribunal values, the reduction, the grounds, a short reason summary and the representing firm. Cash-machine appeals are left out unless sector=atm. Costs 2 credits.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "ba_code": { "description": "Council (billing authority) code, e.g. '5390'. Alternative to council.", "pattern": "^[0-9A-Za-z]{4}$", "type": "string" }, "council": { "description": "Council name or part of it, e.g. 'Hammersmith' or 'Leeds'. Use instead of postcode for a whole council.", "maxLength": 60, "minLength": 3, "type": "string" }, "firm": { "description": "The firm that represented the ratepayer, e.g. 'Colliers'.", "maxLength": 60, "minLength": 2, "type": "string" }, "from": { "description": "Decisions on or after this date (YYYY-MM-DD).", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "ground": { "description": "One of: rental_evidence, tone_of_list_comparables, floor_area_measurement, zoning_layout, material_change_of_circumstances, physical_works_disturbance, repair_state_deletion, split_merger_hereditament, trade_receipts_fmt, valuation_method, effective_date, validity_of_proposal, quantum_allowance, relief_or_exemption, other. Only decisions argued on this ground.", "maxLength": 80, "minLength": 1, "type": "string" }, "include": { "description": "Optional extra sections for the answer. The ones available are listed in the response under settings.include_supported; anything else is ignored and listed in settings.ignored. Leave out unless the user asks for something the normal answer lacks.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "type": "array" }, "limit": { "description": "Decisions to list, 1 to 25 (default 10). The summary always covers every match.", "maximum": 25, "minimum": 1, "type": "integer" }, "list_year": { "description": "2010, 2017, 2023 or 2026. The rating list the appeal was against.", "maxLength": 80, "minLength": 1, "type": "string" }, "options": { "additionalProperties": { "anyOf": [ { "maxLength": 200, "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "description": "Optional extra settings by name. The ones available are listed in the response under settings.options_supported; anything else is ignored and listed in settings.ignored.", "propertyNames": { "maxLength": 60, "type": "string" }, "type": "object" }, "outcome": { "description": "One of: any, won, lost. won = allowed, allowed in part or agreed at the hearing; lost = everything else. Default any.", "maxLength": 80, "minLength": 1, "type": "string" }, "postcode": { "description": "A full postcode ('W6 8DR'), a postcode sector ('W6 8') or a district ('W6').", "maxLength": 9, "minLength": 2, "type": "string" }, "property_id": { "description": "Only decisions about this property (the property_id from find_properties).", "pattern": "^[0-9]{6,15}$", "type": "string" }, "property_type": { "description": "Words from the property description, e.g. 'warehouse', 'shop', 'office'.", "maxLength": 60, "minLength": 2, "type": "string" }, "sector": { "description": "One of: retail, office, industrial, leisure_hospitality, healthcare, education, car_park, other, unknown, atm. The tribunal data's own sector grouping.", "maxLength": 80, "minLength": 1, "type": "string" }, "to": { "description": "Decisions on or before this date (YYYY-MM-DD).", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "search_tribunal_decisions", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:4ea49c611e13a18c3428dc254ba1d0ecf3ddae497c2474ceaa4ee2ebce70a8bc | sha256sum