Companies House, Gazette notices, sanctions screening, LEIs and UK legislation.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional free key from https://fourzerotwo.si/free (raises the free allowance from 100 to 500 calls/day)
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Town, county or postcode area
SIC code
active, dissolved, liquidation…
YYYY-MM-DD
YYYY-MM-DD
Name contains
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.
| Argument | Type | Description |
|---|---|---|
| location | string | Town, county or postcode area |
| sic_codes | string | SIC code |
| company_status | string | active, dissolved, liquidation… |
| incorporated_to | string | YYYY-MM-DD |
| incorporated_from | string | YYYY-MM-DD |
| company_name_includes | string | Name contains |
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "Town, county or postcode area"
},
"sic_codes": {
"type": "string",
"description": "SIC code"
},
"company_status": {
"type": "string",
"description": "active, dissolved, liquidation…"
},
"incorporated_to": {
"type": "string",
"description": "YYYY-MM-DD"
},
"incorporated_from": {
"type": "string",
"description": "YYYY-MM-DD"
},
"company_name_includes": {
"type": "string",
"description": "Name contains"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q* | string | Name |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Name"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | 8-character company number, e.g. "00445790" |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
}
}Search dissolved and removed companies by name. A few free samples a day, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| q* | string | Name |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Name"
}
}
}PSC disclosure exemptions a company holds. A few free samples a day, then $0.002 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | Company number |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "Company number"
}
}
}One filing's detail and document link. A few free samples a day, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | 8-character company number, e.g. "00445790" |
| transaction_id* | string | Transaction id from filing history |
{
"type": "object",
"required": [
"company_number",
"transaction_id"
],
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
},
"transaction_id": {
"type": "string",
"description": "Transaction id from filing history"
}
}
}Accounts, confirmation statements, appointments and other filings, newest first. A few free samples a day, then $0.005 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| category | string | accounts, confirmation-statement, officers, capital, mortgage… |
| company_number* | string | 8-character company number, e.g. "00445790" |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"category": {
"type": "string",
"description": "accounts, confirmation-statement, officers, capital, mortgage…"
},
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
}
}Insolvency cases, practitioners and key dates for a company. A few free samples a day, then $0.008 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | Company number |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "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.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | 8-character company number, e.g. "00445790" |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
}
}Current registered office address. A few free samples a day, then $0.002 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | 8-character company number, e.g. "00445790" |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "8-character company number, e.g. \"00445790\""
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q* | string | Company name or number |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Company name or number"
}
}
}UK branches of an overseas company. A few free samples a day, then $0.002 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | Overseas company number (FC…) |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "Overseas company number (FC…)"
}
}
}Name autocompletion across the LEI index. Free within the daily allowance, then $0.002 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| q* | string | Partial name |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Partial name"
}
}
}Registered branches of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| lei* | string | LEI |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
}
}Which entity holds a SWIFT/BIC code. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| bic* | string | BIC |
{
"type": "object",
"required": [
"bic"
],
"properties": {
"bic": {
"type": "string",
"description": "BIC"
}
}
}Which entity issued a security, by ISIN. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| isin* | string | ISIN |
{
"type": "object",
"required": [
"isin"
],
"properties": {
"isin": {
"type": "string",
"description": "ISIN"
}
}
}Entities directly owned by this entity. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| lei* | string | LEI |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
}
}The direct accounting parent of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| lei* | string | LEI |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q* | string | Approximate name |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Approximate name"
}
}
}Securities (ISINs) issued by an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| lei* | string | LEI |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "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.
| Argument | Type | Description |
|---|---|---|
| lei* | string | 20-character Legal Entity Identifier |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "20-character Legal Entity Identifier"
}
}
}Entities whose legal name matches. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| name* | string | Legal name |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Legal name"
}
}
}The ultimate accounting parent of an entity. Free within the daily allowance, then $0.003 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| lei* | string | LEI |
{
"type": "object",
"required": [
"lei"
],
"properties": {
"lei": {
"type": "string",
"description": "LEI"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| list | string | us-ofac, uk, eu or un |
| list_id | string | The list's own id (list_id in a screen result) |
| entry_id | integer | Or entry_id from a screen result |
{
"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"
}
}
}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.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Person, company or vessel name |
| type | string | individual, entity or vessel |
| lists | string | Comma list: us-ofac,uk,eu,un (default all) |
| country | string | Country to corroborate |
| threshold | integer | Minimum score 50-100 (default 80) |
| birth_year | integer | Birth year to corroborate |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Person, company or vessel name"
},
"type": {
"type": "string",
"description": "individual, entity or vessel"
},
"lists": {
"type": "string",
"description": "Comma list: us-ofac,uk,eu,un (default all)"
},
"country": {
"type": "string",
"description": "Country to corroborate"
},
"threshold": {
"type": "integer",
"description": "Minimum score 50-100 (default 80)"
},
"birth_year": {
"type": "integer",
"description": "Birth year to corroborate"
}
}
}Potential matches on the UK Sanctions List only (FCDO). A few free samples a day, then $0.01 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name |
| threshold | integer | Minimum score (default 80) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name"
},
"threshold": {
"type": "integer",
"description": "Minimum score (default 80)"
}
}
}Potential matches on the US OFAC SDN list only. A few free samples a day, then $0.01 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name |
| threshold | integer | Minimum score (default 80) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name"
},
"threshold": {
"type": "integer",
"description": "Minimum score (default 80)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| address* | string | Wallet address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Wallet address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| company_number* | string | 8-character Companies House number, e.g. "00445790" or "SC123456" |
{
"type": "object",
"required": [
"company_number"
],
"properties": {
"company_number": {
"type": "string",
"description": "8-character Companies House number, e.g. \"00445790\" or \"SC123456\""
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| organisation* | string | Company name |
{
"type": "object",
"required": [
"organisation"
],
"properties": {
"organisation": {
"type": "string",
"description": "Company name"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| amount | string | Disputed amount £ |
| company | string | Who charged you |
| category* | string | subscription, gym, retailer, tradesperson, other_consumer (regulated: credit_card, bank, insurance…) |
| complained_on | string | Date you complain (default today) YYYY-MM-DD |
{
"type": "object",
"required": [
"category"
],
"properties": {
"amount": {
"type": "string",
"description": "Disputed amount £"
},
"company": {
"type": "string",
"description": "Who charged you"
},
"category": {
"type": "string",
"description": "subscription, gym, retailer, tradesperson, other_consumer (regulated: credit_card, bank, insurance…)"
},
"complained_on": {
"type": "string",
"description": "Date you complain (default today) YYYY-MM-DD"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| supplier | string | Supplier |
| bill_date | string | Date of the catch-up bill YYYY-MM-DD |
| charges_from | string | Earliest date the bill charges for |
| complained_on | string | Date of first complaint |
{
"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"
}
}
}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.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| type* | string | council or private |
| amount | string | Charge £ |
| ground | string | Ground key (see response) |
| issuer | string | Council or operator name |
| issued_on* | string | YYYY-MM-DD |
| ticket_kind | string | parking, box_junction, bus_lane (council) |
{
"type": "object",
"required": [
"type",
"issued_on"
],
"properties": {
"type": {
"type": "string",
"description": "council or private"
},
"amount": {
"type": "string",
"description": "Charge £"
},
"ground": {
"type": "string",
"description": "Ground key (see response)"
},
"issuer": {
"type": "string",
"description": "Council or operator name"
},
"issued_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"ticket_kind": {
"type": "string",
"description": "parking, box_junction, bus_lane (council)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| provider | string | Provider |
| complained_on | string | Date of first complaint |
| contract_start | string | Contract start YYYY-MM-DD |
| change_notified_on | string | Date a price/contract change was notified |
{
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| company | string | Water company |
| complained_on | string | Date of first complaint |
{
"type": "object",
"properties": {
"company": {
"type": "string",
"description": "Water company"
},
"complained_on": {
"type": "string",
"description": "Date of first complaint"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the deceased, e.g. "John Smith" |
| limit | integer | Max results (1-50, default 20) |
| death_year | integer | Year of death, e.g. 2023 |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the deceased, e.g. \"John Smith\""
},
"limit": {
"type": "integer",
"description": "Max results (1-50, default 20)"
},
"death_year": {
"type": "integer",
"description": "Year of death, e.g. 2023"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| notice_id* | string | Gazette notice id from a search result |
{
"type": "object",
"required": [
"notice_id"
],
"properties": {
"notice_id": {
"type": "string",
"description": "Gazette notice id from a search result"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| type* | string | Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types) |
| year* | string | Year (or regnal year for pre-1963, e.g. Eliz2/10-11) |
| number* | integer | Chapter or SI number |
{
"type": "object",
"required": [
"type",
"year",
"number"
],
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| type* | string | Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types) |
| year* | string | Year (or regnal year for pre-1963, e.g. Eliz2/10-11) |
| number* | integer | Chapter or SI number |
{
"type": "object",
"required": [
"type",
"year",
"number"
],
"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"
}
}
}The newest Acts and instruments published, optionally of one type. Free within the daily allowance, then $0.001 USDC per call via x402.
| Argument | Type | Description |
|---|---|---|
| type | string | Type code |
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Type code"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| date | string | Point in time, YYYY-MM-DD (default: current revised text) |
| type* | string | Legislation type code (ukpga, uksi, asp, ssi, wsi, nisr…; see types) |
| year* | string | Year (or regnal year for pre-1963, e.g. Eliz2/10-11) |
| number* | integer | Chapter or SI number |
| provision* | string | Path such as section/3, regulation/2, article/5 or schedule/1/paragraph/4 |
{
"type": "object",
"required": [
"type",
"year",
"number",
"provision"
],
"properties": {
"date": {
"type": "string",
"description": "Point in time, YYYY-MM-DD (default: current revised text)"
},
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | integer | Results page (20 per page) |
| text | string | Words anywhere in the text |
| type | string | Type code (see types) |
| year | integer | Year |
| title | string | Words in the title |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Results page (20 per page)"
},
"text": {
"type": "string",
"description": "Words anywhere in the text"
},
"type": {
"type": "string",
"description": "Type code (see types)"
},
"year": {
"type": "integer",
"description": "Year"
},
"title": {
"type": "string",
"description": "Words in the title"
}
}
}Type codes and what they mean. Free within the daily allowance, then $0.0005 USDC per call via x402.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | Keyword filter on title, description and buyer |
| days | integer | Look back 1–7 days (default 3) |
| limit | integer | Max results (default 20, max 50) |
| stage | string | planning, tender (default) or award |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword filter on title, description and buyer"
},
"days": {
"type": "integer",
"description": "Look back 1–7 days (default 3)"
},
"limit": {
"type": "integer",
"description": "Max results (default 20, max 50)"
},
"stage": {
"type": "string",
"description": "planning, tender (default) or award"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Contracts Finder GUID or Find a Tender notice number |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Contracts Finder GUID or Find a Tender notice number"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | Keywords (title, description, buyer, supplier) |
| type | string | contract, pipeline, early-engagement or future-opportunity |
| limit | integer | Max results (default 20, max 50) |
| status | string | open, closed, awarded or withdrawn |
| min_value | integer | Minimum value in £ |
| published_to | string | YYYY-MM-DD |
| published_from | string | YYYY-MM-DD |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keywords (title, description, buyer, supplier)"
},
"type": {
"type": "string",
"description": "contract, pipeline, early-engagement or future-opportunity"
},
"limit": {
"type": "integer",
"description": "Max results (default 20, max 50)"
},
"status": {
"type": "string",
"description": "open, closed, awarded or withdrawn"
},
"min_value": {
"type": "integer",
"description": "Minimum value in £"
},
"published_to": {
"type": "string",
"description": "YYYY-MM-DD"
},
"published_from": {
"type": "string",
"description": "YYYY-MM-DD"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| supplier* | string | Supplier name (matched as a phrase) |
| published_from | string | YYYY-MM-DD |
{
"type": "object",
"required": [
"supplier"
],
"properties": {
"supplier": {
"type": "string",
"description": "Supplier name (matched as a phrase)"
},
"published_from": {
"type": "string",
"description": "YYYY-MM-DD"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | Filter by name or id |
| kind | string | all, countries or groups |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Filter by name or id"
},
"kind": {
"type": "string",
"description": "all, countries or groups"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| code* | string | Commodity code, 6–10 digits (padded to 10), e.g. 0901210000 |
| country | string | Country of origin, ISO alpha-2 (e.g. CN, US, IN) — filters measures to those that apply |
{
"type": "object",
"required": [
"code"
],
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Year |
| month* | integer | Month 1–12 |
| currency | string | ISO currency code, e.g. USD (default: all) |
{
"type": "object",
"required": [
"year",
"month"
],
"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)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| code* | string | 4-digit heading, e.g. 0901 |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "4-digit heading, e.g. 0901"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page |
| status | string | open, exhausted, blocked, critical or not_exhausted |
| country | string | Country of origin, ISO alpha-2 |
| order_number | string | 6-digit quota order number |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Page"
},
"status": {
"type": "string",
"description": "open, exhausted, blocked, critical or not_exhausted"
},
"country": {
"type": "string",
"description": "Country of origin, ISO alpha-2"
},
"order_number": {
"type": "string",
"description": "6-digit quota order number"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q* | string | Product description |
| limit | integer | Max results (default 15, max 30) |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Product description"
},
"limit": {
"type": "integer",
"description": "Max results (default 15, max 30)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| from | string | net (default) or gross |
| rate | string | VAT rate in percent (or give country) |
| amount* | string | Amount |
| country | string | Use this country's standard rate |
{
"type": "object",
"required": [
"amount"
],
"properties": {
"from": {
"type": "string",
"description": "net (default) or gross"
},
"rate": {
"type": "string",
"description": "VAT rate in percent (or give country)"
},
"amount": {
"type": "string",
"description": "Amount"
},
"country": {
"type": "string",
"description": "Use this country's standard rate"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| country | string | ISO code (omit for all) |
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "ISO code (omit for all)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| vat_number* | string | VAT number with country prefix |
{
"type": "object",
"required": [
"vat_number"
],
"properties": {
"vat_number": {
"type": "string",
"description": "VAT number with country prefix"
}
}
}