UK Business Tools - Ledgerhall
Ledgerhall
UK public data for AI agents. One connection. Companies House, Land Registry, GOV.UK, courts, Parliament — your agent gets the lot.
https://uk-business-mcp.fly.dev/mcpNo API key. No account. Free and hosted.
What you can do
Once connected, your AI agent can:
Check any UK company — directors, shareholders, filing history, disqualified officers
Research property — comparable sales, EPC ratings, Rightmove listings, rental yields, stamp duty
Search case law and legislation — court judgments, Acts, Hansard debates, HMRC guidance
Query GOV.UK — search 700k+ pages, resolve postcodes to councils, find policy documents
Run due diligence — cross-reference Companies House, Charity Commission, Land Registry, Gazette insolvency, sanctions lists
Related MCP server: companies-house-mcp
Setup
claude.ai
Go to Settings (bottom left)
Click MCP Servers
Click Add
Paste:
https://uk-business-mcp.fly.dev/mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"ledgerhall": {
"type": "http",
"url": "https://uk-business-mcp.fly.dev/mcp"
}
}
}Claude Code
claude mcp add --transport http ledgerhall https://uk-business-mcp.fly.dev/mcpChatGPT
Go to Settings → Connected apps → Add MCP server
Paste:
https://uk-business-mcp.fly.dev/mcp
Cursor / other editors
Add to .cursor/mcp.json:
{
"mcpServers": {
"ledgerhall": {
"url": "https://uk-business-mcp.fly.dev/mcp"
}
}
}What's inside
Ledgerhall is a FastMCP proxy that bundles four specialist UK MCP servers into one endpoint. Each server covers a different part of the UK public record.
Prefix | Server | Coverage |
| 700k+ GOV.UK pages, organisations, postcodes | |
| Case law, legislation, Hansard, HMRC guidance, OSCOLA | |
| Companies House, Charity Commission, Land Registry, Gazette, sanctions | |
| Land Registry, EPC, Rightmove, yields, stamp duty, planning |
How it works
Pure proxy — no data storage, no custom tools. Every request is forwarded to the appropriate backend. Tool lists are cached for 5 minutes. Built with FastMCP create_proxy() and mount().
Coming next
UK Compliance — FCA Register and SRA solicitor checks
UK Statistics — ONS economic data and Nomis labour market profiles
New servers appear automatically. No config changes needed.
Links
Product page: bouch.dev/products/uk-business-mcp
Free AI skills: bouch.dev/tools
All servers: bouch.dev/products
Built by: BOUCH — AI consultancy, East Midlands
License
MIT
Available Tools
76 toolsdd_charity_profileGet Charity ProfileARead-onlyIdempotent
Fetch the full Charity Commission profile for a charity number.
Returns trustees, latest income/expenditure, insolvency flags, classifications, and countries of operation. Use charity_search first to find the charity number.
Inputs: charity_number (required). Returns: Full Charity Commission profile for a single charity.
dd_charity_searchSearch Charity Commission RegisterARead-onlyIdempotent
Search the Charity Commission register of England and Wales by name or keyword.
Returns matching charities with registration number, status, and
registration date. Use charity_profile for full details once you
have the charity number. The upstream searchCharityName endpoint
returns the full list in one shot — pagination is applied
client-side via offset/limit. A query that matches nothing is a
successful empty result (charities: []), not an error — the
upstream endpoint signals "no matches" with an HTTP 404, which is
translated back into an empty result here rather than surfaced as
a not-found failure.
Inputs: query (required), limit, offset. Returns: Paginated result of a Charity Commission name search.
dd_company_chargesGet Company ChargesARead-onlyIdempotent
Fetch the complete Companies House charge history for a company.
Returns every registered charge (secured debt) — current and historic — with status, dates, secured parties, and what each charge covers (fixed/floating/negative-pledge flags and any free-text particulars). Satisfaction is represented as satisfied_on plus a charge-satisfaction filing entry, not a separate 'release' record. company_profile.has_charges is a True/False/unknown summary derived from this same data; use this tool when the specific charges matter, not just whether any exist.
Inputs: company_number (required). Returns: Complete charge history for a company.
dd_company_filing_documentGet Companies House Filing DocumentARead-onlyIdempotent
Resolve a filing's document_metadata link to its authoritative source document.
Returns a resource_link (never embedded bytes, never base64) pointing at a company-document:// MCP resource — fetch it via resources/read to get the actual PDF. This tool only reads metadata (category, pages, available content types, byte size); it never downloads the document itself. Use company_filing_history first to find a filing's document_metadata URL.
Requires a resource-capable MCP client to retrieve the actual bytes — a tool-only client can see this result's metadata (company, category, page count, size) but cannot obtain the file through this tool call alone.
Inputs: document_metadata_url (required), mime_type.
dd_company_filing_historyGet Company Filing HistoryARead-onlyIdempotent
Fetch one page of a company's Companies House filing chronology.
Returns the raw source facts for each filing — transaction ID, form type/category, dates, and the description_values CH uses to render its own text — as delivered upstream, not interpreted into DD conclusions. links.document_metadata on each filing is the identifier a future document-retrieval tool would need; no document content is fetched here.
Unlike company_officers/company_psc/company_charges, this does NOT auto-fetch every page — a long-lived company's filing history is unbounded in practice (a decades-old PLC can carry thousands of filings). total_count/returned/has_more are always reported truthfully for whatever page and category filter was requested; nothing is silently truncated. Narrow with category= for a specific slice (e.g. category='mortgage' for charge-related filings, category='insolvency' for administration/liquidation filings) — a note is included when an unfiltered history is large.
A company_number that doesn't resolve to any company returns a structured not_found error, distinct from a genuine zero-filing result — Companies House's filing-history endpoint alone cannot tell these apart, so existence is confirmed separately when the result would otherwise be empty.
Inputs: company_number (required), category, start_index, items_per_page. Returns: One page of Companies House filing-history results for a company. Not an auto-f…
dd_company_officersGet Company OfficersARead-onlyIdempotent
Fetch officers for a Companies House company number.
Returns directors, secretaries, and other officers with appointment dates, nationality, and country of residence. Resigned officers are excluded by default; set include_resigned=true for historical DD. Pagination is handled internally.
Inputs: company_number (required), start_index, items_per_page, include_resigned. Returns: List of officers for a given company.
dd_company_profileGet Company ProfileARead-onlyIdempotent
Fetch the full Companies House profile for a company number.
Returns status, registered address, SIC codes, filing compliance (overdue accounts and confirmation statement flags), and whether the company has outstanding charges. Use company_search first to find the company number.
Inputs: company_number (required). Returns: Full Companies House profile for a single company number.
dd_company_pscGet Persons with Significant ControlARead-onlyIdempotent
Fetch Persons with Significant Control (beneficial ownership) for a company.
Returns PSC entries with natures of control, nationality, and country of residence. Flags overseas corporate PSC entries as a beneficial ownership risk signal. Returns an explanatory note for widely-held PLCs with no registrable PSC.
Inputs: company_number (required). Returns: List of Persons with Significant Control for a company.
dd_company_searchSearch Companies HouseARead-onlyIdempotent
Search the Companies House register by company name or keyword.
Returns a paginated list of matching companies with name, number, status, incorporation date, and registered address. SIC codes are not reliably returned by search; use company_profile for SIC codes. Use company_profile for the full record once you have the company number. Re-call with start_index=start_index+items_per_page to fetch the next page.
Inputs: query (required), start_index, company_type, company_status, +1 more. Returns: Paginated result of a Companies House company search.
dd_disqualified_profileGet Disqualified Director ProfileARead-onlyIdempotent
Fetch the full disqualification record for a director by officer ID.
Returns all disqualification orders: reason, Act/section cited, disqualification period, and associated company names. Use disqualified_search first to find the officer ID.
Inputs: officer_id (required). Returns: Full disqualification record for a disqualified officer.
dd_disqualified_searchSearch Disqualified DirectorsARead-onlyIdempotent
Check whether a named individual is banned from acting as a UK company director.
Use this tool when asked to check disqualified, banned, or barred directors. Query must be an individual's name (e.g. "Richard Howson") — NOT a company name, which always returns zero results.
Returns names, dates of birth, match snippets (often empty), and officer IDs that can be used with disqualified_profile for full details. The disqualification periods come from disqualified_profile.
Inputs: name, query, start_index, items_per_page. Returns: Paginated disqualified officers search result.
dd_fetchFetch Full Record from UK Due Diligence RegisterARead-onlyIdempotent
Fetch the full record for an ID returned by search.
Routes by prefix to the appropriate register:
company:{number} → Companies House full profile
charity:{number} → Charity Commission full profile
disqualification:{officer_id} → Disqualified director full record
notice:{notice_id} → Gazette notice full legal text
Inputs: id (required). Returns: object
dd_gazette_insolvencySearch Gazette Corporate Insolvency NoticesARead-onlyIdempotent
Search The Gazette's insolvency notice index by entity name.
Searches The Gazette's corporate-insolvency notice index using the authoritative Gazette notice-code taxonomy. Results are sorted by an internal DD severity score; the notice label itself remains a source fact.
Each result includes a notice_numeric_id. Read the full legal wording via the notice://{notice_numeric_id} resource.
The Gazette is the official UK public record. A notice here means the event has been formally published. This tool does not establish its legal effect.
Inputs: name, query, end_date, start_date, +3 more. Returns: Aggregated Gazette insolvency notice search result.
dd_gazette_noticeGet Gazette Notice Full TextARead-onlyIdempotent
Fetch the full legal wording of a Gazette notice by numeric notice ID.
Returns the JSON-LD linked-data record for the notice: publisher, notice code, publication date, and the party fields the Gazette supplies. Body text and court are not guaranteed; the Gazette web page has the full wording. Use gazette_insolvency first to find notice_numeric_id values.
Inputs: notice_id (required). Returns: object
dd_land_title_searchSearch Price Paid Transactions by PostcodeARead-onlyIdempotent
Search HM Land Registry Price Paid Index by postcode or address.
Returns up to 10 recent sale transactions for the postcode: price, date, address, property type, and tenure (Freehold/Leasehold). Covers England and Wales only. Postcode gives the most reliable results — a full address is also accepted and the postcode is extracted automatically.
Inputs: address_or_postcode (required). Returns: HMLR Price Paid Index search result for a given postcode.
dd_officer_appointmentsGet Officer Appointment HistoryARead-onlyIdempotent
Fetch a person's full company appointment history by officer ID.
Returns every appointment — current and historic — with each company's number, name, status, role, and appointment/resignation dates. Use company_officers first to find an officer_id, then this tool to discover other companies that person has been a director or secretary of, including dissolved or insolvent ones not mentioned anywhere else. Always returns full history; there is no current-only filter, since historical discovery is the point.
Inputs: officer_id (required). Returns: A person's full appointment history across companies, by officer ID.
dd_sanctions_screenScreen a Name Against Sanctions ListsARead-onlyIdempotent
Screen a name against the UK (OFSI), US (OFAC), EU and UN consolidated sanctions lists.
Returns every list entry whose primary name or alias matches, with the regime, source reference and listing date where the source gives one. Use it to check whether a counterparty — or its officers / persons with significant control — appears on a sanctions list.
MATCHING is deterministic: normalised exact + alias match (case-, accent- and punctuation-insensitive). A company/entity legal name matches reliably; PERSON names with transliteration variants may not (e.g. 'Mohammed' vs 'Muhamad'). An empty result is therefore NOT a guarantee of clearance, and a hit on a common name may be a false positive to disambiguate. This is a screening aid, not a compliance determination.
lists_screened reports which of OFSI/OFAC/EU/UN were actually loaded;
lists_unavailable names those that were not, and is_partial is true
whenever it is non-empty or the lists are a previous load that could not
be refreshed (as_at then shows when they were loaded). When is_partial
is true an empty hits is UNRESOLVED, not clearance. If no list could be
loaded at all the call raises a retryable error rather than returning an
empty screen. as_at is when the lists were last refreshed on this server.
Inputs: name (required), entity_type. Returns: Result of screening one name against the consolidated sanctions lists.
dd_searchSearch UK Due Diligence RegistersARead-onlyIdempotent
Search across all UK due diligence registers simultaneously.
Searches Companies House, Charity Commission, disqualified directors, and Gazette insolvency notices in parallel. Returns a list of result IDs — use fetch with each ID to retrieve the full record.
registers_searched names the registers that actually answered and
registers_unavailable those that failed; is_partial is true whenever
the latter is non-empty. An empty ids with is_partial true means
UNRESOLVED, not "nothing on record". If no register answers at all the
call raises rather than returning an empty result.
Inputs: query (required). Returns: object
gov_govuk_get_contentGet GOV.UK PageARead-onlyIdempotent
Get metadata and navigable section index for a GOV.UK page.
Returns the page title, document type, publication dates, and a list of sections with their anchor IDs and headings. Use govuk_get_section to read the body of a specific section, or govuk_grep_content to search within the page body.
Inputs: base_path (required). Returns: object
gov_govuk_get_organisationGet GOV.UK OrganisationARead-onlyIdempotent
Get the profile of a UK government organisation by its slug.
Returns name, acronym, type, status, web URL, and parent/child organisations. Use govuk_list_organisations to browse all organisations and discover slugs.
Inputs: slug (required). Returns: A UK government organisation record.
gov_govuk_get_sectionGet GOV.UK Page SectionARead-onlyIdempotent
Get the HTML content of one named section of a GOV.UK page.
Use govuk_get_content first to get the list of available section anchors, then call this with the anchor of the section you want to read.
Inputs: anchor (required), base_path (required). Returns: object
gov_govuk_grep_contentSearch within a GOV.UK content bodyARead-onlyIdempotent
Find body sections in a GOV.UK content item matching a pattern.
Returns a list of {anchor, heading, snippet, match} hits — small per-section
snippets centred on the match — so the LLM can decide which full sections to
read via govuk_get_section.
Use this when answering content-based questions ("what does this guide say about X?", "find the bit about eligibility") rather than navigating by section number.
Pattern is regex; if it doesn't compile, falls back to literal substring.
Inputs: pattern (required), base_path (required), max_hits, case_insensitive. Returns: Output schema for govuk_grep_content.
gov_govuk_list_organisationsList GOV.UK OrganisationsARead-onlyIdempotent
List all UK government organisations registered on GOV.UK.
Returns a paginated list of organisations including their slug, acronym, type, and status. Use this to browse the full government structure or discover slugs for use with govuk_get_organisation or govuk_search filters.
Inputs: page, per_page. Returns: A page of UK government organisations.
gov_govuk_lookup_postcodeLook Up UK PostcodeARead-onlyIdempotent
Look up a UK postcode to retrieve its local authority, region, constituency, and other administrative geography.
Useful for determining which council area, parliamentary constituency, or NHS region a postcode falls within. Commonly used to direct users to the correct local service on GOV.UK (e.g. council tax, planning, waste).
Uses the postcodes.io public API (no key required).
Inputs: postcode (required). Returns: UK postcode lookup result with administrative geography.
gov_govuk_searchSearch GOV.UKARead-onlyIdempotent
Search GOV.UK's 700k+ content items using the official Search API.
Returns a list of matching content items with title, description, link, format, owning organisation(s), and last updated timestamp.
Use filter_format to narrow to specific content types (e.g. 'transaction' for citizen-facing services, 'guide' for guidance, 'publication' for official documents). Use filter_organisations to restrict to a department.
Inputs: query (required), count, order, start, +2 more. Returns: A page of GOV.UK search results.
law_bills_get_billGet Bill DetailARead-onlyIdempotent
USE THIS TOOL WHEN you have a bill_id (from bills_search_bills) and want the full detail.
Returns sponsors, current stage, long title, summary, and Royal Assent date if enacted. Summary text is capped per max_summary_chars — check summary_truncated in the response.
AFTER calling, use parliament_search_hansard(query=bill_short_title) to find the bill's parliamentary debates, or bills_search_bills with a related keyword for adjacent bills.
Inputs: bill_id (required), max_summary_chars. Returns: id, url, is_act, stages, +10 more
law_bills_search_billsSearch Parliamentary BillsARead-onlyIdempotent
USE THIS TOOL WHEN searching UK parliamentary bills by keyword, session, house, or legislative stage.
Returns a paginated page of bill summaries (title, originating and current house, current stage, whether it became an Act). AFTER calling, pass a bill_id into bills_get_bill for full detail (sponsors, long title, Royal Assent date).
Authoritative source for UK parliamentary bill status.
Inputs: query (required), house, limit, stage, +2 more. Returns: One page of bill search results. Wraps matching BillSummary records with search…
law_case_law_grep_judgmentSearch within a UK Court JudgmentARead-onlyIdempotent
USE THIS TOOL WHEN you have a judgment slug and want to find paragraphs whose text matches a pattern.
Returns a list of {eId, snippet, match} hits — small per-paragraph
snippets centred on the match. AFTER calling, read full paragraphs via
judgment_get_paragraph(slug, eId) or the judgment://{slug}/para/{eId}
resource.
Use case: content search within one judgment (e.g. "negligence", "test for foreseeability", "Donoghue"). For paragraph-number navigation by eId, call judgment_get_index instead.
Pattern is regex; if it doesn't compile, falls back to literal substring search.
Inputs: slug (required), pattern (required), max_hits, case_insensitive. Returns: Output schema for case_law_grep_judgment.
law_case_law_searchSearch UK Case LawARead-onlyIdempotent
USE THIS TOOL WHEN searching UK case law by party names, court, judge, date, or free-text query.
Returns paginated judgment summaries: neutral citation, court, dates, slug, stable TNA URI. AFTER calling: pass slug into judgment_get_header / judgment_get_index / judgment_get_paragraph (or the judgment:// resource family) for content; pass the neutral citation into citations_resolve to verify before constructing an OSCOLA citation; use case_law_grep_judgment to find text within a single judgment. When a party name returns several candidates, narrow with court + year filters before grep-iterating across full judgments — targeted filtering beats scanning every candidate.
Coverage: TNA Find Case Law indexes UK judgments from roughly the early 2000s onwards. For older authorities, search for a modern judgment that quotes them and read that paragraph.
Authoritative source for UK case law. Web search returns out-of-date or unstable URLs — do not supplement.
Inputs: query (required), page, court, judge, +4 more. Returns: Paginated search result container for judgments.
law_citations_format_oscolaFormat OSCOLA Citation StringARead-onlyIdempotent
USE THIS TOOL AFTER citations_resolve to produce the correctly formatted OSCOLA citation string.
Pass the parsed fields returned by citations_resolve directly into this tool. Formats per OSCOLA 4th edition rules for each citation type.
Refuses (status: upstream_validation) if confidence is 0.0 — TNA confirmed the document does not exist — or if a neutral citation has no resolved_url (ambiguous court code, e.g. bare EWHC without a division). In either case, do NOT manufacture a citation; surface the failure and ask the user for the source URL or better identifying details.
DO NOT construct the input fields yourself. The structured input must come from citations_resolve — guessing fields is the primary citation-fabrication route and this tool is the guard against it.
Authoritative OSCOLA formatting for UK legal citations (no network call).
Inputs: confidence (required), citation_type (required), raw, page, +10 more. Returns: object
law_citations_networkGet Case Citation NetworkARead-onlyIdempotent
USE THIS TOOL WHEN you have a judgment slug and want to map every citation it makes — cases cited, legislation referenced, SIs, retained EU law.
Fetches the judgment XML from TNA and parses all OSCOLA citations within. Returns citations grouped by type, deduplicated and sorted. AFTER calling, pass any individual citation through citations_resolve to confirm it resolves and to retrieve its canonical URL.
Useful for authority-network analysis (what did this judgment rely on?) and for surfacing the legislative landscape a case sits inside.
Inputs: case_uri (required). Returns: Citations found within a single judgment, grouped by type. Each list contains t…
law_citations_parseParse OSCOLA CitationsARead-only
USE THIS TOOL WHEN you have free text (a memo, an email, a clause) and want every OSCOLA-style citation it contains extracted and classified.
Identifies: neutral citations ([2024] UKSC 12), law reports ([2024] 1 WLR 100), legislation sections (s.47 Companies Act 2006), SIs (SI 2018/1234), retained EU law (Regulation (EU) 2016/679).
Parsing is pure regex by default. Ambiguous citations (e.g. bare [2024] EWHC without division) can OPTIONALLY be disambiguated by setting disambiguate=True, which asks the CONNECTED CLIENT's own model (not this server) to resolve the division via MCP sampling — off by default. Citations resolve to TNA / legislation.gov.uk URLs when possible.
AFTER calling, pass each citation through citations_resolve to verify it points at a real document before quoting or formatting it — the parser recognises the SHAPE of a citation but does not confirm the document exists.
Inputs: text (required), disambiguate. Returns: Result of parsing all OSCOLA citations from a body of text.
law_citations_resolveResolve Single OSCOLA CitationARead-onlyIdempotent
USE THIS TOOL BEFORE constructing an OSCOLA citation string from known fields, OR to confirm a citation points at a real document.
Parses + resolves a single citation (neutral citation, SI, legislation section, retained EU law) and returns parsed fields plus resolved_url. For neutral citations, performs a live TNA HEAD check — non-200 sets confidence to 0.0 (document absent). Do NOT format or quote a confidence-0.0 citation.
If the TNA HEAD check fails (timeout, connection error), raises ToolError with {"error_category": "transient", "is_retryable": true}. One retry is attempted — retry this call or proceed without TNA verification.
Formatting a citation from "known" fields without prior resolution is the most common fabrication route. If this tool raises or returns no resolved_url, do NOT manufacture a citation — surface the failure and ask the user for the source URL.
Authoritative source for UK legal-citation resolution.
Inputs: citation (required). Returns: A single parsed OSCOLA citation with optional resolution.
law_committees_get_committeeGet Committee DetailARead-onlyIdempotent
USE THIS TOOL WHEN you have a committee_id and want the metadata + current membership.
Fetches committee detail and member list in parallel. AFTER calling, pass committee_id into committees_search_evidence to see what evidence has been submitted to this committee on what topics.
Inputs: committee_id (required). Returns: id, url, name, email, +3 more
law_committees_search_businessesSearch Committee Inquiries and BusinessARead-onlyIdempotent
USE THIS TOOL WHEN identifying a committee inquiry or business before evidence retrieval.
Returns official business IDs, titles, types, dates, and report/status metadata. AFTER calling, use an exact ID as committee_business_id in committees_search_evidence. Source: UK Parliament Committees API CommitteeBusiness endpoint.
Inputs: committee_id (required), limit, query. Returns: query, total, businesses, committee_id
law_committees_search_committeesSearch Parliamentary CommitteesARead-onlyIdempotent
USE THIS TOOL WHEN searching or listing UK parliamentary select committees by name, house, or active status.
Returns committee summaries (name, house, active status, ID). AFTER calling, pass committee_id into committees_get_committee for current membership, or into committees_search_evidence to retrieve oral and written evidence submitted to that committee.
Inputs: house, limit, query, active_only. Returns: Result of a committees_search_committees call.
law_committees_search_evidenceSearch Committee EvidenceARead-onlyIdempotent
USE THIS TOOL WHEN retrieving committee evidence, especially for an identified inquiry.
Returns ONE PAGE of evidence (default 20) plus total, the source's
count of matching items. evidence_type='both' lists all oral evidence
first, then all written evidence, each newest-published first as the
source orders it. Free-text titles are capped per max_title_chars;
witness lists are capped at 10 per item. An organisation witness (no
named individual) is rendered as ' ()'; a null
entry means the source gave no name for that witness at all. For
committees with many submissions, re-call with offset=offset+returned
while has_more is true. For inquiry-specific research, first call
committees_search_businesses and pass its exact committee_business_id;
this filters at the authoritative source before pagination.
Source: UK Parliament Committees API oral and written evidence endpoints.
Inputs: committee_id (required), limit, offset, published_to, +4 more. Returns: A page of evidence submissions to a parliamentary committee. Returned by commit…
law_get_promptGet PromptARead-onlyIdempotent
Get a prompt by name with optional arguments.
Returns the rendered prompt as JSON with a messages array. Arguments should be provided as a dict mapping argument names to values.
Inputs: name (required), arguments. Returns: result
law_hmrc_check_mtd_statusCheck MTD VAT StatusARead-onlyIdempotent
USE THIS TOOL WHEN you have a 9-digit VAT Registration Number and need that business's Making Tax Digital VAT mandate status.
Returns whether the business is mandated for MTD, effective date, and trading name.
Connects to the HMRC sandbox by default. Set HMRC_API_BASE to 'https://api.service.hmrc.gov.uk' for production. Requires HMRC_CLIENT_ID + HMRC_CLIENT_SECRET environment variables (OAuth 2.0). Raises if credentials are not configured — do not infer status.
Inputs: vrn (required). Returns: Making Tax Digital VAT status for a VAT registration number.
law_hmrc_get_manual_pageRead HMRC Internal Manual PageARead-onlyIdempotent
USE THIS TOOL WHEN a cited HMRC internal-manual page must be read.
Returns bounded source-order text, canonical URL, manual reference, source metadata, and retrieval provenance. AFTER calling, cite or analyse only returned text; if retrieval fails, do not infer the page's contents. Source: the allowlisted official GOV.UK HMRC internal-manual page.
Inputs: max_chars, reference, manual_url, manual_family. Returns: Bounded content retrieved from one canonical HMRC internal-manual page.
law_hmrc_get_vat_rateGet VAT Rate for CommodityARead-onlyIdempotent
USE THIS TOOL WHEN you know the UK VAT category name for a good or service and want its VAT treatment.
Exact named-category lookup, not a free-text VAT classifier or tax advice. The query must equal a category name, ignoring only case, spacing, hyphens and apostrophe style. Extra qualifying words are never discarded: 'pet food' is its own category, and 'baby food' is not 'food'.
A match returns rate (standard, reduced, zero or exempt),
rate_percentage (None for exempt), conditions in notes, the GOV.UK
source_url, and that entry's verified_on date.
An unresolved query returns no rate: matched_category, rate,
rate_percentage and verified_on are all null, never a default.
Its notes list the category names. AFTER an unresolved result, retry
with a listed name or call hmrc_search_guidance.
Inputs: commodity_code (required). Returns: VAT rate for a commodity or service. Backed by a small static lookup table, not…
law_hmrc_search_guidanceSearch HMRC GuidanceARead-onlyIdempotent
USE THIS TOOL WHEN discovering HMRC GOV.UK guidance on a topic.
Returns official-search titles, URLs, descriptions, and published dates; descriptions do not establish the contents of a cited page. AFTER calling, use hmrc_get_manual_page when a result is an HMRC internal-manual URL. Source: GOV.UK's HMRC-filtered content search API.
Inputs: query (required), limit. Returns: Result of an HMRC guidance search on GOV.UK. Wraps the list of matching guidanc…
law_judgment_get_headerGet Judgment HeaderARead-onlyIdempotent
USE THIS TOOL WHEN you have a judgment slug and need metadata (parties, judges, neutral citation, court, dates).
Call case_law_search FIRST to get the slug. AFTER calling, use judgment_get_index to discover paragraphs, then judgment_get_paragraph to read specific ones. Authoritative source for UK judgment metadata.
Inputs: slug (required). Returns: object
law_judgment_get_indexGet Judgment Paragraph IndexARead-onlyIdempotent
USE THIS TOOL WHEN you have a judgment slug and want the paragraph navigation index (eId + preview line for every paragraph).
Call case_law_search FIRST to get the slug. AFTER calling, pass an eId from the returned list into judgment_get_paragraph to read that paragraph's full text, or use case_law_grep_judgment for content search across all paragraphs.
Inputs: slug (required). Returns: object
law_judgment_get_paragraphGet Judgment ParagraphARead-onlyIdempotent
USE THIS TOOL WHEN you have a judgment slug + LegalDocML eId and want that paragraph's full text.
Call judgment_get_index FIRST to discover available eIds (or use case_law_grep_judgment to locate paragraphs by content). Returns the paragraph XML content (400–1,700 tokens typical).
Inputs: eId (required), slug (required). Returns: object
law_legislation_get_sectionGet Legislation SectionARead-onlyIdempotent
USE THIS TOOL WHEN you have a known Act / SI and want the parsed text of a specific section, regulation, or article, with extent and in-force metadata.
Returns the provision's own text and heading, never a neighbouring Part/Chapter. Also returns extent, in-force/prospective data, and truncation metadata. Pass the bare number: the tool handles Act sections and SI regulations/articles. A missing provision raises not_found rather than returning a plausible neighbouring node.
AFTER calling, check extent before relying on the provision and
inspect content_truncated for long text. Call legislation_get_toc to
discover valid numbers, or read_resource with a legislation:// URI
when raw CLML XML is required.
Source: legislation.gov.uk CLML, with an explicitly marked public-HTML fallback only when CLML is unavailable.
Inputs: type (required), year (required), number (required), section (required), +1 more. Returns: A single section of an Act or SI, with full metadata.
law_legislation_get_tocGet Legislation Table of ContentsARead-onlyIdempotent
USE THIS TOOL WHEN you have a known Act / SI and want the structural table of contents (parts, chapters, individual sections/regulations/articles).
Returns XML ids and titles in document order, including Parts, chapters, crossheadings, and provisions; a rare untitled provision is retained as its bare id. Results are paginated with offset/limit.
AFTER calling, pass a provision's bare number (for example 47, not
section-47) to legislation_get_section. Check has_more and
total_items for large statutes. Use read_resource with the
legislation:// toc URI for the full raw listing.
Source: legislation.gov.uk CLML table of contents.
Inputs: type (required), year (required), number (required), limit, +1 more. Returns: Paginated table of contents for an Act or Statutory Instrument. The upstream XM…
law_legislation_searchSearch UK LegislationARead-onlyIdempotent
USE THIS TOOL WHEN searching UK Acts and Statutory Instruments by title, phrase, or full-text.
Returns ranked results: title, type, year, number, legislation.gov.uk URL, and next_steps hints (toc URI, section template). AFTER calling, chain to legislation_get_toc then legislation_get_section for structural drill-in.
Filter discipline: type and year are exact-match. Use only when you
already know the value. For currency-driven searches, query by phrase
and read the returned year; guessing an exact year can zero results.
For broader concept queries across content, set fulltext=True. If the
default title route receives a typed legislation.gov.uk WAF/non-XML
failure, the tool automatically tries that documented full-text route
once and marks search_mode="fulltext_fallback"; its broader relevance
semantics must not be treated as a title-ranked result. Render-pending
and ordinary HTTP failures do not trigger this fallback.
Source: legislation.gov.uk Atom search feed, with an explicit fallback marker when the alternative official full-text route supplied results.
Inputs: query (required), type, year, limit, +1 more. Returns: Container for legislation search results.
law_list_promptsList PromptsARead-onlyIdempotent
List all available prompts.
Returns JSON with prompt metadata including name, description, and optional arguments.
Inputs: no named parameters. Returns: result
law_list_resourcesList ResourcesARead-onlyIdempotent
List all available resources and resource templates.
Returns JSON with resource metadata. Static resources have a 'uri' field, while templates have a 'uri_template' field with placeholders like {name}.
Inputs: no named parameters. Returns: result
law_parliament_find_memberFind Member of ParliamentARead-onlyIdempotent
USE THIS TOOL WHEN you have a member's name and need their integer member_id.
Returns all members matching the name query, each with the integer id,
party, constituency, house, and current-sitting status. Disambiguates
common-name matches (e.g. "Lord Smith" returns multiple peers).
CALL THIS BEFORE any tool that filters by member_id — including parliament_get_debate_contributions, parliament_member_debates, and parliament_member_interests. Name → ID first; ID-based filtering second. Skipping this step and text-searching by name returns unrelated results (see parliament_search_hansard's anti-bypass note for the Pannick case).
Inputs: name (required). Returns: Result of a parliament member name search. Wraps the list of matching members w…
law_parliament_get_debate_contributionsGet Contributions In A DebateARead-onlyIdempotent
USE THIS TOOL WHEN you have a debate_ext_id and want verbatim contributions, optionally filtered to one member.
Canonical path for "everything a member said in this debate" regardless of vocabulary — text-search tools (parliament_member_debates, parliament_search_hansard) filter by contribution TEXT, dropping members who spoke without using your phrase verbatim. This tool filters by MemberId on the debate's Items list, so vocabulary doesn't matter.
Typical chain: parliament_find_member(name) → member_id, then parliament_search_hansard or parliament_lookup_by_column → debate_ext_id, then this tool. The parliament module's instructions describe the full composition pattern.
Without member_id, returns every contribution (~100-200 for a long debate).
If the wire returns no contributions for a member you expect to have spoken, report the empty result honestly — do NOT reconstruct quotes from training data. Authoritative source for member contributions.
Inputs: debate_ext_id (required), member_id. Returns: Result of a member-filtered Hansard search. Wraps the contributions for one mem…
law_parliament_get_debate_divisionsGet Divisions Held In A DebateARead-onlyIdempotent
USE THIS TOOL WHEN you have a debate_ext_id and want the divisions (formal votes) held within it.
Most debates contain no divisions — Business of the House sittings, statements, urgent questions, debates without a vote. A populated list typically appears around bill stages, motions, and contested amendments. Empty list is the honest result, not a failure mode.
Each returned division carries TWO IDs:
id— Hansard-side reference. Useful for cross-referencing in Hansard.votes_id— Lords/Commons Votes API ID (cross-resolved by date+number). AFTER calling, passvotes_idasdivision_idinto votes_get_division for the full member-by-member voting record.
The two upstreams use distinct ID-spaces (Hansard Number=3 might be
Votes-API divisionId=3392). The cross-resolve runs once per (date, house)
group — typically one extra HTTP per debate. votes_id is None when the
cross-resolve found no match.
Inputs: debate_ext_id (required). Returns: Divisions held within a specific debate. Empty `divisions` is the normal case —…
law_parliament_lookup_by_columnResolve A Hansard Column CitationARead-onlyIdempotent
USE THIS TOOL WHEN you have an OSCOLA-style Hansard citation (column + volume + house) and need the debate.
Example input: 'HL Deb 14 Oct 2025, vol 849, col 200'. AFTER calling, read the contribution at the cited column via read_resource(uri="hansard://debate/{debate_ext_id}/header") — or, equivalently, call parliament_get_debate_contributions(debate_ext_id) for the full list as a structured tool response.
Each match carries:
contribution_count— real contribution count from the debate's Itemssource/source_code— citation finality (1=Rolling, 2=Daily, 3=BoundVolume, 4=Historic). Resolution is NOT gated on publication state.
Empty matches typically means the volume_number is wrong (opposing
counsel sometimes cites running-volume rather than bound-volume) or the
column is in a Written Statement (use the 'W'-suffixed column as-is).
It does NOT mean the citation is fabricated — surface the failure.
Authoritative source for OSCOLA Hansard column resolution.
Inputs: column_number (required), volume_number (required), house. Returns: Result of looking up a Hansard citation by (volume, column). Each match is a de…
law_parliament_member_debatesGet Member DebatesARead-onlyIdempotent
USE THIS TOOL WHEN you have a member_id and want contributions where THAT member used a specific topic phrase verbatim (text-body search).
CALL parliament_find_member(name) FIRST to obtain the integer member_id.
This is a name-based text-body search — it matches contributions whose TEXT contains the topic phrase. A member who spoke in a debate but didn't use your phrase verbatim is filtered out. For verbatim retrieval of every contribution by a member in a known debate (regardless of vocabulary), use parliament_get_debate_contributions(debate_ext_id, member_id=...) instead.
Each contribution's text field is capped at 3000 characters.
Inputs: member_id (required), limit, topic, offset. Returns: Result of a member-filtered Hansard search. Wraps the contributions for one mem…
law_parliament_member_interestsGet Member Financial InterestsARead-onlyIdempotent
USE THIS TOOL WHEN you have a member_id and need their registered financial interests (donations, directorships, land, gifts).
CALL parliament_find_member(name) FIRST to obtain the integer member_id.
Returns ONE PAGE of interests (default 20, caller controls via limit). For prolific members (big donors, many directorships, extensive land holdings), re-call with offset=offset+returned while has_more is true to paginate. Description text is capped per max_description_chars; raise it for forensic provenance work that needs the full narrative.
This is the authoritative source for UK MP and peer financial-interest declarations (via the Members API). Web search returns stale snapshots.
Inputs: member_id (required), limit, offset, category, +1 more. Returns: A page of registered financial interests for a member. Returned by parliament_m…
law_parliament_policy_position_summaryHansard Policy Position Summary (deterministic facets)ARead-onlyIdempotent
USE THIS TOOL WHEN you want debate-level corpus signals on a topic — by_house, by_year, by_section breakdowns — without reading every contribution.
Aggregates Hansard debate-level signals on a topic. Pure counts — no LLM, no editorial labels. Sweeps /search/Debates.json with pagination (up to max_debates_scanned), then aggregates by_house, by_section, by_year, by_month, and top_debates from debate metadata. Also captures the corpus-wide envelope counts (total_contributions, total_written_statements, total_divisions, etc.) from /search.json for cross-section scope.
AFTER calling, pick a debate from top_debates and pass its debate_ext_id into parliament_get_debate_contributions to drill into who said what.
Note on member-level facets: Hansard's search API exposes debate metadata, not per-contribution member identifiers, at the corpus level. by_party and top_contributors are therefore omitted from this deterministic summary. To see who spoke in a specific debate, read hansard://debate/{debate_ext_id}/header for an ordered contribution index, or call parliament_member_debates for one named member.
This is the authoritative source for UK Hansard corpus-level signals.
Inputs: topic (required), house, to_date, from_date, +1 more. Returns: Aggregate, member-agnostic Hansard signals on a topic. Pure counts — no editori…
law_parliament_search_hansardSearch Hansard DebatesARead-onlyIdempotent
USE THIS TOOL WHEN searching Hansard by topic, bill title, or text phrase.
Returns source-backed contributions with citation-grade metadata: member_id, attributed_to, column_ref, debate_id, debate_ext_id, contribution_ext_id, and public URL. The independent corpus envelope is optional enrichment: if it cannot be retrieved after one bounded retry, contributions still return with enrichment_status="degraded" and an explicit warning; omitted corpus totals and previews must not be inferred. AFTER calling, drill into full content via read_resource(uri="hansard://debate/{debate_ext_id}/header") — or call parliament_get_debate_contributions(debate_ext_id) for the same content as a structured tool response.
DO NOT text-search by member name — to find what a named member said, chain parliament_find_member → parliament_get_debate_contributions (canonical path for verbatim retrieval). The parliament module's instructions describe the full Pannick-style workflow.
Pagination: limit + offset honour the upstream paginated endpoint. For breadth across a topic, see parliament_policy_position_summary.
Source: UK Parliament Hansard API. Contributions remain the authoritative retrieval result; envelope fields are source-backed only when complete.
Inputs: query (required), house, limit, offset, +5 more. Returns: Result of a Hansard debate search. Wraps the list of matching contributions wit…
law_parliament_search_petitionsSearch UK Parliament PetitionsARead-onlyIdempotent
USE THIS TOOL WHEN searching UK Parliament petitions by keyword or topic.
Returns petition title, state, signature count, and dates for government response or parliamentary debate if applicable. Filter by state (open, closed, debated, etc.) to narrow to live or historical petitions.
This is the authoritative source for UK Parliament petitions (petition.parliament.uk).
Inputs: query (required), limit, state, offset. Returns: Result of a UK Parliament petitions search. Wraps the matching petitions with t…
law_read_resourceRead ResourceARead-onlyIdempotent
Read a registered server resource URI, not an ordinary web URL.
USE WHEN you have a judgment://, legislation://, hansard://, or server:// URI returned by this server. Do not use for https:// URLs; use the source-specific tool instead (for a canonical GOV.UK HMRC internal-manual URL, call hmrc_get_manual_page).
Returns the resource content as a string. Binary content is base64-encoded.
AFTER calling, use the returned primary-source content and URI in citations; if the URI is rejected, follow the named source-specific tool rather than treating the URL as retrieved evidence.
Source: registered UK Legal MCP resource providers.
Inputs: uri (required). Returns: result
law_votes_get_divisionGet Division DetailARead-onlyIdempotent
USE THIS TOOL WHEN you have a division_id + house and want the full member-by-member voting record.
Voter lists are truncated to 100 per side to fit response limits; total voter counts are always accurate regardless of truncation. Chain from votes_search_divisions or parliament_get_debate_divisions (which cross-resolves Hansard division refs into votes-API division_ids).
Inputs: division_id (required), house. Returns: id, date, house, title, +9 more
law_votes_search_divisionsSearch Parliamentary DivisionsARead-onlyIdempotent
USE THIS TOOL WHEN searching Commons or Lords formal votes by topic, date, or member.
Returns one page of division summaries (title, date, vote counts,
pass/fail) plus total, the source's count of all matching divisions.
While has_more is true, re-call with offset=offset+returned. AFTER
calling, pass division_id + house into votes_get_division for the full
member-by-member voter lists.
Authoritative source for UK parliamentary vote records.
Inputs: house, limit, query, offset, +3 more. Returns: Result of a parliamentary divisions search. Wraps the list of matching division…
prop_company_searchBRead-only
Search Companies House for a company by name.
Inputs: name (required). Returns: object
prop_epc_certificateARead-only
Fetch a single EPC certificate by its GOV.UK certificate number.
Use after property_epc_summaries has listed the candidates and you have picked one — this is faster than property_epc(postcode, address) as it makes a direct lookup with no address matching or postcode re-fetch.
The parameter is named lmk_key as a compatibility alias; pass the certificate number, which is returned in every property_epc_summaries row. (property_epc_search is deprecated and raises — do not call it.)
Returns the full EPC certificate, or null only when no such certificate is lodged. A null result means no such certificate is lodged. If the EPC service cannot be reached the tool raises an error instead — never treat an error as evidence that a property has no certificate.
Inputs: lmk_key (required). Returns: result
prop_planning_searchARead-only
Find the council planning portal URL for a postcode.
Inputs: postcode (required). Returns: object
prop_ppd_transactionsARead-only
Land Registry Price Paid transactions for a postcode, most recent first.
Returns up to limit most recent transactions within snapshot coverage
(coverage_from-coverage_to in the response's provenance).
Unfiltered by default -- category-B bulk transfers and commercial sales are
included. Pass property_type (F=flat, D=detached, S=semi, T=terraced,
O=other) to restrict the result to a single type.
Not a complete property history. Check provenance.older_records_exist
and provenance.sample_complete before saying anything about what a
property has or has not sold for. An empty result means "no sales within
the stated coverage" -- never "never sold". For clean residential
comparable sales, use property_comps.
Inputs: postcode (required), limit, property_type. Returns: object
prop_property_blocksBRead-only
Property block analysis — identify buildings with multiple flat sales (block-buy opportunities).
Inputs: postcode (required), months, search_level. Returns: object
prop_property_compsARead-only
Comparable sales from Land Registry Price Paid Data.
Defaults return the standard residential set:
property_type=None means residential (F+D+S+T). Pass "F"/"D"/"S"/"T"/"O" for a single type, or "ALL" to disable type filtering (firehose).
transaction_category defaults to "A" (standard sales). Pass None to include category-B (bulk transfers, non-standard conveyances).
filter_outliers=False by default; set True for IQR-trimmed stats AND transaction list (1.5*IQR rule, needs >=4 prices).
limit caps returned transactions (max 200). enrich_epc attaches EPC floor area and price-per-sqft to each transaction — slower but richer.
Inputs: postcode (required), limit, months, address, +5 more. Returns: object
prop_property_epcARead-only
Energy Performance Certificate data for a UK property or postcode area.
With address: returns the matched EPC certificate for that specific property. Without address: returns the record count and, when the bounded response contains every matching summary, the rating distribution. Property-type breakdown and floor-area statistics are NOT available — the EPC service exposes them only on individual certificates.
Returns null only when no certificates are lodged for the postcode. A null result means no such certificate is lodged. If the EPC service cannot be reached the tool raises an error instead — never treat an error as evidence that a property has no certificate.
Inputs: postcode (required), address. Returns: result
prop_property_epc_searchARead-only
DEPRECATED — use property_epc_summaries then epc_certificate.
This tool returned score, floor_area, property_type, habitable_rooms and inspection_date for every certificate at a postcode. The EPC service no longer exposes those fields in a search: they exist only on a full certificate. Reproducing the old response would require one upstream request per certificate, so this tool is unsupported rather than silently degraded or silently expensive.
Inputs: postcode (required). Returns: result
prop_property_epc_summariesARead-only
List EPC certificate summaries at a postcode — for candidate selection.
Returns one bounded page. Each entry contains only what the EPC search exposes: certificate_number, address, uprn (often absent), energy band, registration_date and schema_type. Energy score, floor area and property type are NOT available here — fetch a specific certificate for those.
Workflow when a Rightmove listing has no house number:
property_epc_summaries(postcode) to list candidates.
Narrow by address text and, where present, uprn.
epc_certificate(lmk_key=<certificate_number>) for the chosen one, then cross-check its floor_area against the listing.
If several candidates remain equally plausible, present them all — do not guess. Selecting arbitrarily attaches another property's data.
complete is false when the postcode holds more records than this page
returns. Upstream page traversal is not snapshot-stable, so a multi-page
result is a bounded sample, not a guaranteed-complete set.
An empty results list means no certificates are lodged. If the EPC service
cannot be reached the tool raises an error instead — never treat an error as
evidence that a property has no certificate.
Inputs: postcode (required), page. Returns: object
prop_property_yieldARead-only
Gross rental yield for a UK postcode.
Combines Land Registry sale comps (median sale price) with Rightmove rental listings (median monthly rent) to produce a gross yield percentage.
Inputs: postcode (required), months, search_level, auto_escalate, +1 more. Returns: object
prop_rental_analysisBRead-only
Rental market analysis and achievable rent estimate.
auto_escalate widens the Rightmove search RADIUS when fewer than 5 listings are found (thin market). This is rental-radius escalation and is unaffected by the PPD geography containment: it does not change a postcode's outcode or sector, so it carries none of the limit-dependence that disabled PPD auto-widening. Response includes thin_market, escalated_from, escalated_to fields when escalation occurs.
Inputs: postcode (required), radius, auto_escalate, purchase_price. Returns: object
prop_rightmove_listingARead-only
Full detail for a single Rightmove listing.
property_id is the numeric Rightmove property ID (the digits at the end of a rightmove.co.uk/properties/... URL), max 12 digits. Full URLs are not accepted. include_images fetches and embeds photos and floorplans as MCP image content. max_images caps the number of property photos (default 3); floorplans always included.
Inputs: property_id (required), max_images, include_images.
prop_rightmove_searchCRead-only
Fetch Rightmove listings for a postcode.
listing_type: "sale" or "rent". sort_by: "newest", "most_reduced", "price_asc", "price_desc". Images are excluded from results.
Inputs: postcode (required), radius, sort_by, max_pages, +4 more. Returns: result
prop_stamp_dutyARead-only
UK Stamp Duty Land Tax (SDLT) calculation with full breakdown.
Inputs: price (required), non_resident, first_time_buyer, additional_property. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 76 tools
There are several genuinely overlapping tools across modules: dd_company_search vs prop_company_search, dd_land_title_search vs prop_ppd_transactions vs prop_property_comps, and four EPC-related tools including a deprecated one. Descriptions often explain the intended chain, so it is not chaotic, but an agent still faces multiple unclear boundaries when choosing a tool.
Names are all snake_case and grouped by module prefixes (law_, dd_, gov_, prop_), but the internal convention is mixed: some use resource_action (dd_company_search, prop_property_comps), others action_resource (law_case_law_search, gov_govuk_search). The redundant gov_govuk_ prefix and duplicate concepts like company_search/property_search make the pattern only partly predictable.
At 76 tools this is far beyond a manageable MCP surface for an agent, even for a broad UK business/legal/property suite. The count includes deprecated and overlapping tools, which increases selection burden rather than adding proportional capability.
Coverage is very broad: case law, legislation, Hansard, committees, bills, votes, citations, HMRC, Companies House, charities, disqualifications, Gazette notices, sanctions, Land Registry, EPC, Rightmove, planning, and SDLT. The remaining gaps are comparatively minor, such as planning only returning a portal URL and some document retrieval being delegated to MCP resources.
Maintenance
Related MCP Connectors
Data and tools for your AI agent: company, people, SEO, social and EU register data. Pay per call.
400+ data APIs for agents: UK companies, property, trade, tenders, recalls, sanctions. Free tier
UK area & property intelligence for AI agents: reports, EPC, comparables, with source provenance.
UK public data tools for agents: companies, tenders, property, stats, documents. No key to start
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides UK company lookups via Companies House, web scraping, and search tools designed to be context-efficient for AI agents. It includes integrated micro-payment monetization and supports data extraction and format conversion.-
- AlicenseAqualityDmaintenanceEnables AI assistants to search and retrieve UK Companies House data including company profiles, officers, and filing history via the official API.4199 npm1MIT
- AlicenseAqualityAmaintenanceEnables AI agents to investigate corporate ownership, trace ultimate beneficial owners, screen sanctions, detect offshore exposure, and access fully cited dossiers from 130M+ entities across 31 global registries.2196 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve UK company data, including company details by Companies House number, group ownership structures, website associations, and Real-Time Industrial Classification definitions.MIT