UK company & compliance data
Companies House, Gazette notices, sanctions screening, LEIs and UK legislation.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"uk-business": {
"url": "https://fourzerotwo.si/mcp/v/uk-business"
}
}
}Remote endpoints
https://fourzerotwo.si/mcp/v/uk-businessstreamable-httpWhat it can do
Tool inventory
Tools (58)
🟢gleif__lookup(lei)
Legal name, addresses, jurisdiction, legal form, status and registration for one LEI. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character Legal Entity Identifier"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__search(name)
Entities whose legal name matches. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Legal name"
}
},
"required": [
"name"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__fuzzy(q)
Best fuzzy matches of a name to LEIs — for messy company names. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Approximate name"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__autocomplete(q)
Name autocompletion across the LEI index. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Partial name"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__direct-parent(lei)
The direct accounting parent of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__ultimate-parent(lei)
The ultimate accounting parent of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__direct-children(lei)
Entities directly owned by this entity. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__branches(lei)
Registered branches of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__by-isin(isin)
Which entity issued a security, by ISIN. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"isin": {
"type": "string",
"description": "ISIN"
}
},
"required": [
"isin"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__by-bic(bic)
Which entity holds a SWIFT/BIC code. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"bic": {
"type": "string",
"description": "BIC"
}
},
"required": [
"bic"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢gleif__isins(lei)
Securities (ISINs) issued by an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
},
"required": [
"lei"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢sanctions__screen-uk(name, threshold)
Potential matches on the UK Sanctions List only (FCDO). A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name"
},
"threshold": {
"type": "integer",
"description": "Minimum score (default 80)"
}
},
"required": [
"name"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢sanctions__screen-us(name, threshold)
Potential matches on the US OFAC SDN list only. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name"
},
"threshold": {
"type": "integer",
"description": "Minimum score (default 80)"
}
},
"required": [
"name"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢sanctions__entry(list, list_id, entry_id)
Full record for a matched entry: all aliases, programmes, countries, dates of birth and remarks. A few free samples a day, then $0.005 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"list": {
"type": "string",
"description": "us-ofac, uk, eu or un"
},
"list_id": {
"type": "string",
"description": "The list's own id (list_id in a screen result)"
},
"entry_id": {
"type": "integer",
"description": "Or entry_id from a screen result"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢sanctions__lists
Which lists are mirrored, entry counts, list dates and last sync time. A few free samples a day, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢sanctions__screen(name, type, birth_year, country, lists, ...)
Potential matches across all four lists with score, list, programmes, countries and dates of birth. A few free samples a day, then $0.02 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Person, company or vessel name"
},
"type": {
"type": "string",
"description": "individual, entity or vessel"
},
"birth_year": {
"type": "integer",
"description": "Birth year to corroborate"
},
"country": {
"type": "string",
"description": "Country to corroborate"
},
"lists": {
"type": "string",
"description": "Comma list: us-ofac,uk,eu,un (default all)"
},
"threshold": {
"type": "integer",
"description": "Minimum score 50-100 (default 80)"
}
},
"required": [
"name"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢sanctions__wallet-screen(address)
Whether a crypto address (BTC, ETH/EVM, TRX, USDT and others) is listed against a designated party on the OFAC SDN list. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Wallet address"
}
},
"required": [
"address"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢companies-house__alphabetical-search(q)
Companies listed alphabetically around a name — good for name-availability checks. A few free samples a day, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Name"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__dissolved-search(q)
Search dissolved and removed companies by name. A few free samples a day, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Name"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__profile(company_number)
Status, type, incorporation date, SIC codes, accounts and confirmation statement due dates, registered office. A few free samples a day, then $0.005 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__registered-office(company_number)
Current registered office address. A few free samples a day, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__filing-history(company_number, category)
Accounts, confirmation statements, appointments and other filings, newest first. A few free samples a day, then $0.005 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
},
"category": {
"type": "string",
"description": "accounts, confirmation-statement, officers, capital, mortgage…"
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__filing(company_number, transaction_id)
One filing's detail and document link. A few free samples a day, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
},
"transaction_id": {
"type": "string",
"description": "Transaction id from filing history"
}
},
"required": [
"company_number",
"transaction_id"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__charges(company_number)
Mortgages and charges registered against a company, with lenders and status. A few free samples a day, then $0.008 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__insolvency(company_number)
Insolvency cases, practitioners and key dates for a company. A few free samples a day, then $0.008 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "Company number"
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__exemptions(company_number)
PSC disclosure exemptions a company holds. A few free samples a day, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "Company number"
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__uk-establishments(company_number)
UK branches of an overseas company. A few free samples a day, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "Overseas company number (FC…)"
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__search(q)
Find UK companies by name or number, with status, address and incorporation date. A few free samples a day, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Company name or number"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢companies-house__advanced-search(company_name_includes, company_status, sic_codes, location, incorporated_from, ...)
Filter companies by name, status, SIC code, location and incorporation dates. A few free samples a day, then $0.005 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_name_includes": {
"type": "string",
"description": "Name contains"
},
"company_status": {
"type": "string",
"description": "active, dissolved, liquidation…"
},
"sic_codes": {
"type": "string",
"description": "SIC code"
},
"location": {
"type": "string",
"description": "Town, county or postcode area"
},
"incorporated_from": {
"type": "string",
"description": "YYYY-MM-DD"
},
"incorporated_to": {
"type": "string",
"description": "YYYY-MM-DD"
}
}
}Output Schema
{
"type": "object",
"description": "The source's response as {data, source{name, licence, attribution}}.",
"additionalProperties": true
}🟢uk-business__due-diligence(company_number)
Register profile plus risk flags: status, overdue accounts or confirmation statement, late accounts, insolvency history, Gazette notices, recent name/office changes, LEI and sanctions name screen. Costs $0.08 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8-character Companies House number, e.g. \"00445790\" or \"SC123456\""
}
},
"required": [
"company_number"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__complaints-contact(organisation)
Verified complaints address, email, phone and URL for a UK company (energy, telecoms, water, finance…). A few free samples a day, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"organisation": {
"type": "string",
"description": "Company name"
}
},
"required": [
"organisation"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__organisations
Organisations in the complaints directory, private parking operators and UK councils (with London flag). A few free samples a day, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__energy-complaint(supplier, bill_date, charges_from, complained_on)
Back-billing (12-month rule) check, Ombudsman timeline and cited rules for a UK energy complaint. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"supplier": {
"type": "string",
"description": "Supplier"
},
"bill_date": {
"type": "string",
"description": "Date of the catch-up bill YYYY-MM-DD"
},
"charges_from": {
"type": "string",
"description": "Earliest date the bill charges for"
},
"complained_on": {
"type": "string",
"description": "Date of first complaint"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__telecoms-complaint(provider, complained_on, contract_start, change_notified_on)
ADR timeline (6 or 8 weeks), price-rise rules and penalty-free exit window for a UK telecoms complaint. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "Provider"
},
"complained_on": {
"type": "string",
"description": "Date of first complaint"
},
"contract_start": {
"type": "string",
"description": "Contract start YYYY-MM-DD"
},
"change_notified_on": {
"type": "string",
"description": "Date a price/contract change was notified"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__water-complaint(company, complained_on)
Two-stage complaint, CCW referral and Guaranteed Standards Scheme timeline (England & Wales). A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"company": {
"type": "string",
"description": "Water company"
},
"complained_on": {
"type": "string",
"description": "Date of first complaint"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__parking-appeal(type, issued_on, issuer, ticket_kind, ground, ...)
Council PCN or private charge: route, deadlines, grounds, tribunal, cited law and strategy. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "council or private"
},
"issued_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"issuer": {
"type": "string",
"description": "Council or operator name"
},
"ticket_kind": {
"type": "string",
"description": "parking, box_junction, bus_lane (council)"
},
"ground": {
"type": "string",
"description": "Ground key (see response)"
},
"amount": {
"type": "string",
"description": "Charge £"
}
},
"required": [
"type",
"issued_on"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-disputes__consumer-charge(category, company, amount, complained_on)
Subscription, gym, retailer or tradesperson charge: rules that apply (Consumer Rights Act 2015), what to ask for, and the escalation ladder to a small claim. Regulated claims are signposted instead. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "subscription, gym, retailer, tradesperson, other_consumer (regulated: credit_card, bank, insurance…)"
},
"company": {
"type": "string",
"description": "Who charged you"
},
"amount": {
"type": "string",
"description": "Disputed amount £"
},
"complained_on": {
"type": "string",
"description": "Date you complain (default today) YYYY-MM-DD"
}
},
"required": [
"category"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-gazette__notice(notice_id)
Structured detail for one deceased-estates notice: address, date of death, executor and claim deadline. A few free samples a day, then $0.02 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"notice_id": {
"type": "string",
"description": "Gazette notice id from a search result"
}
},
"required": [
"notice_id"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-gazette__deceased-estates(name, death_year, limit)
Search UK deceased-estates notices by the deceased's name, optionally narrowed to a year of death. A few free samples a day, then $0.01 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the deceased, e.g. \"John Smith\""
},
"death_year": {
"type": "integer",
"description": "Year of death, e.g. 2023"
},
"limit": {
"type": "integer",
"description": "Max results (1-50, default 20)"
}
},
"required": [
"name"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__item(type, year, number)
Title, long title, enactment/made date, status, extent, count of outstanding changes and the full table of contents. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types)"
},
"year": {
"type": "string",
"description": "Year (or regnal year for pre-1963, e.g. Eliz2/10-11)"
},
"number": {
"type": "integer",
"description": "Chapter or SI number"
}
},
"required": [
"type",
"year",
"number"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__changes(type, year, number)
Most recent 50 changes (substitutions, repeals, insertions…) made by later legislation, with the amending provision, in-force dates and whether the change is reflected in the text yet. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types)"
},
"year": {
"type": "string",
"description": "Year (or regnal year for pre-1963, e.g. Eliz2/10-11)"
},
"number": {
"type": "integer",
"description": "Chapter or SI number"
}
},
"required": [
"type",
"year",
"number"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__latest(type)
The newest Acts and instruments published, optionally of one type. Free within the daily allowance, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Type code"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__types
Type codes and what they mean. Free within the daily allowance, then $0.0005 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__search(title, text, type, year, page)
Find Acts and instruments by title words or full text, optionally by type and year. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Words in the title"
},
"text": {
"type": "string",
"description": "Words anywhere in the text"
},
"type": {
"type": "string",
"description": "Type code (see types)"
},
"year": {
"type": "integer",
"description": "Year"
},
"page": {
"type": "integer",
"description": "Results page (20 per page)"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-legislation__provision(type, year, number, provision, date)
Plain numbered text of one section, regulation, article or schedule paragraph, as it stands today or on a past date, with amendment and commencement notes. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types)"
},
"year": {
"type": "string",
"description": "Year (or regnal year for pre-1963, e.g. Eliz2/10-11)"
},
"number": {
"type": "integer",
"description": "Chapter or SI number"
},
"provision": {
"type": "string",
"description": "Path such as section/3, regulation/2, article/5 or schedule/1/paragraph/4"
},
"date": {
"type": "string",
"description": "Point in time, YYYY-MM-DD (default: current revised text)"
}
},
"required": [
"type",
"year",
"number",
"provision"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-tenders__search(q, status, type, published_from, published_to, ...)
Contracts Finder notices by keyword, status (open, closed, awarded, withdrawn), type and publication date, optionally above a minimum value. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keywords (title, description, buyer, supplier)"
},
"status": {
"type": "string",
"description": "open, closed, awarded or withdrawn"
},
"type": {
"type": "string",
"description": "contract, pipeline, early-engagement or future-opportunity"
},
"published_from": {
"type": "string",
"description": "YYYY-MM-DD"
},
"published_to": {
"type": "string",
"description": "YYYY-MM-DD"
},
"min_value": {
"type": "integer",
"description": "Minimum value in £"
},
"limit": {
"type": "integer",
"description": "Max results (default 20, max 50)"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-tenders__notice(id)
One notice in full: description, CPV codes, contract dates, procedure and awards (supplier, value, dates). Accepts a Contracts Finder id (GUID) or a Find a Tender notice number (e.g. 095302-2026). Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Contracts Finder GUID or Find a Tender notice number"
}
},
"required": [
"id"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-tenders__supplier-awards(supplier, published_from)
Contracts Finder awards won by a supplier (name match), newest first, with total value. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"supplier": {
"type": "string",
"description": "Supplier name (matched as a phrase)"
},
"published_from": {
"type": "string",
"description": "YYYY-MM-DD"
}
},
"required": [
"supplier"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-tenders__find-a-tender-latest(days, stage, q, limit)
Above-threshold UK notices published or updated on Find a Tender in the last 1–7 days, by stage (planning, tender, award), optionally filtered by keyword. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Look back 1–7 days (default 3)"
},
"stage": {
"type": "string",
"description": "planning, tender (default) or award"
},
"q": {
"type": "string",
"description": "Keyword filter on title, description and buyer"
},
"limit": {
"type": "integer",
"description": "Max results (default 20, max 50)"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__search(q, limit)
Candidate commodity codes, headings and chapters for a product description ("roasted coffee", "lithium battery"), best match first. Free within the daily allowance, then $0.003 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Product description"
},
"limit": {
"type": "integer",
"description": "Max results (default 15, max 30)"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__commodity(code, country)
One commodity code: description, section/chapter/heading, third-country duty and every import/export measure (preferential rates, VAT, additional duties, controls with document codes). Give country to keep only what applies to that origin. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Commodity code, 6–10 digits (padded to 10), e.g. 0901210000"
},
"country": {
"type": "string",
"description": "Country of origin, ISO alpha-2 (e.g. CN, US, IN) — filters measures to those that apply"
}
},
"required": [
"code"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__heading(code)
A 4-digit heading and every commodity code under it, with indents and whether each is declarable. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "4-digit heading, e.g. 0901"
}
},
"required": [
"code"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__quotas(order_number, country, status, page)
Quota definitions with status (open, exhausted, critical), initial volume, remaining balance and validity, by order number or country of origin. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"order_number": {
"type": "string",
"description": "6-digit quota order number"
},
"country": {
"type": "string",
"description": "Country of origin, ISO alpha-2"
},
"status": {
"type": "string",
"description": "open, exhausted, blocked, critical or not_exhausted"
},
"page": {
"type": "integer",
"description": "Page"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__areas(kind, q)
Tariff geographical areas: countries and the groups used in measures (e.g. 1011 ERGA OMNES, 1013 European Union, trade agreements), with group members. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "all, countries or groups"
},
"q": {
"type": "string",
"description": "Filter by name or id"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢uk-trade-tariff__exchange-rates(year, month, currency)
HMRC's monthly exchange rates used to convert invoice values for customs and import VAT, units per £1. Free within the daily allowance, then $0.002 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "Year"
},
"month": {
"type": "integer",
"description": "Month 1–12"
},
"currency": {
"type": "string",
"description": "ISO currency code, e.g. USD (default: all)"
}
},
"required": [
"year",
"month"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢vat__rates(country)
Standard, reduced and super-reduced VAT rates for one country or all of EU27 + UK, with the date they were checked. Free within the daily allowance, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "ISO code (omit for all)"
}
}
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢vat__calculate(amount, rate, country, from)
Net to gross or gross to net at a given rate, or at a country's standard rate. Free within the daily allowance, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": "string",
"description": "Amount"
},
"rate": {
"type": "string",
"description": "VAT rate in percent (or give country)"
},
"country": {
"type": "string",
"description": "Use this country's standard rate"
},
"from": {
"type": "string",
"description": "net (default) or gross"
}
},
"required": [
"amount"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}🟢vat__validate-format(vat_number)
Country format and check digit for UK (GB/XI) and EU VAT numbers. Does not confirm registration. Free within the daily allowance, then $0.001 USDC per call via x402.
Input Schema
{
"type": "object",
"properties": {
"vat_number": {
"type": "string",
"description": "VAT number with country prefix"
}
},
"required": [
"vat_number"
]
}Output Schema
{
"type": "object",
"description": "This endpoint's JSON response.",
"additionalProperties": true
}Community
Evidence