UK Legal Research

Official35 tools

by paulieb89 · Python

UK legal research — case law, legislation, Hansard, bills, votes, committees, HMRC, citations

io.github.paulieb89/uk-legal-mcp MCP Server

This MCP server provides UK legal research resources, including case law, legislation, Hansard, bills, votes, committees, HMRC materials, and citations. It exposes tooling count of 35, and is positioned for developers working with legal information and citations, including OS-COLA topics.

🛠️ Key Features

UK legal research: case law, legislation, Hansard
Bills, votes, committees, and HMRC content
Citation support and OS-COLA focus

🚀 Use Cases

Retrieve UK case law and legislation for research
Find Hansard references and related parliamentary materials
Look up bills, votes, and committee information linked to citations

⚡ Developer Benefits

Integrates via MCP as an mcp-server
Uses established legal indexing topics (including oscola)
Developer discoverability via published repository identifiers and tooling set (35 tools)

⚠️ Limitations

Descriptions provided specify available research areas, but do not detail authentication, accuracy guarantees, or citation format handling.

Topics

ai-skillscase-lawclaudehansardlegallegislationmcpmcp-serverukoscola

Captured live from the server via tools/list.

judgment_get_header

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.

Parameters1

slug

string

required

Judgment slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Judgment slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'",
      "maxLength": 200,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

judgment_get_index

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.

Parameters1

slug

string

required

Judgment slug, e.g. 'uksc/2024/12'

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Judgment slug, e.g. 'uksc/2024/12'",
      "maxLength": 200,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

judgment_get_paragraph

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).

Parameters2

eId	string	required	Paragraph eId from judgment_get_index, e.g. 'para_12'. Numeric strings like '12' are accepted and normalized to 'para_12'.
slug	string	required	Judgment slug, e.g. 'uksc/2024/12'

Raw schema

{
  "type": "object",
  "properties": {
    "eId": {
      "description": "Paragraph eId from judgment_get_index, e.g. 'para_12'. Numeric strings like '12' are accepted and normalized to 'para_12'.",
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    },
    "slug": {
      "description": "Judgment slug, e.g. 'uksc/2024/12'",
      "maxLength": 200,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "slug",
    "eId"
  ],
  "additionalProperties": false
}

case_law_search

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.

Parameters8

court	any	optional	Filter by court slug. Values: 'uksc', 'ukpc', 'ewca/civ', 'ewca/crim', 'ewhc/kb', 'ewhc/ch', 'ewhc/comm', 'ewhc/fam', 'ewhc/pat', 'ewhc/ipec', 'ewhc/admin', 'ewhc/tcc', 'ewhc/costs', 'ewfc', 'ewcop', 'eat', 'ukut/iac', 'ukut/aac', 'ukut/tcc', 'ukut/lc', 'ukftt/tc', 'ukftt/grc', 'nica', 'niqb'.
from_date	any	optional	Earliest judgment date (YYYY-MM-DD). NOTE: the TNA atom.xml endpoint currently appears to ignore this filter — the same results come back regardless. Do not rely on it to narrow output; sort+slice client-side or refine `query` instead.
judge	any	optional	Filter by judge surname. Case-insensitive substring match against the indexed form. Use the surname alone ('Reed', 'Sumption') or with the bare title ('Lord Reed'). Honorific suffixes silently zero the result set — do not append 'JSC', 'of Allermuir', 'KC' etc. Speculating a fuller form than what TNA indexed will return 0 hits with no error.
limit	integer	optional	Maximum results to return (1–50). TNA returns up to 50 per request; this slices client-side. Default 10 for a tight shortlist. Set higher for breadth (e.g. 50 to scan the full result set).
page	integer	optional	Result page number (1-indexed)
party	any	optional	Filter by party name
query	string	required	Full-text search query, e.g. 'negligence duty of care'
to_date	any	optional	Latest judgment date (YYYY-MM-DD). Same caveat as `from_date` — currently silently ignored by upstream. Filtering happens client-side at best.

Raw schema

{
  "type": "object",
  "properties": {
    "court": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by court slug. Values: 'uksc', 'ukpc', 'ewca/civ', 'ewca/crim', 'ewhc/kb', 'ewhc/ch', 'ewhc/comm', 'ewhc/fam', 'ewhc/pat', 'ewhc/ipec', 'ewhc/admin', 'ewhc/tcc', 'ewhc/costs', 'ewfc', 'ewcop', 'eat', 'ukut/iac', 'ukut/aac', 'ukut/tcc', 'ukut/lc', 'ukftt/tc', 'ukftt/grc', 'nica', 'niqb'."
    },
    "from_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Earliest judgment date (YYYY-MM-DD). NOTE: the TNA atom.xml endpoint currently appears to ignore this filter — the same results come back regardless. Do not rely on it to narrow output; sort+slice client-side or refine `query` instead."
    },
    "judge": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by judge surname. Case-insensitive substring match against the indexed form. Use the surname alone ('Reed', 'Sumption') or with the bare title ('Lord Reed'). Honorific suffixes silently zero the result set — do not append 'JSC', 'of Allermuir', 'KC' etc. Speculating a fuller form than what TNA indexed will return 0 hits with no error."
    },
    "limit": {
      "default": 10,
      "description": "Maximum results to return (1–50). TNA returns up to 50 per request; this slices client-side. Default 10 for a tight shortlist. Set higher for breadth (e.g. 50 to scan the full result set).",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "page": {
      "default": 1,
      "description": "Result page number (1-indexed)",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "party": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by party name"
    },
    "query": {
      "description": "Full-text search query, e.g. 'negligence duty of care'",
      "maxLength": 500,
      "minLength": 1,
      "type": "string"
    },
    "to_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latest judgment date (YYYY-MM-DD). Same caveat as `from_date` — currently silently ignored by upstream. Filtering happens client-side at best."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

case_law_grep_judgment

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.

Parameters4

case_insensitive	boolean	optional	Default true. Set false for case-sensitive matching.
max_hits	integer	optional	Cap on number of hits returned.
pattern	string	required	Regex pattern (or plain substring) to search within paragraph text. If the pattern doesn't compile as regex, falls back to literal substring match.
slug	string	required	TNA judgment slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'.

Raw schema

{
  "type": "object",
  "properties": {
    "case_insensitive": {
      "default": true,
      "description": "Default true. Set false for case-sensitive matching.",
      "type": "boolean"
    },
    "max_hits": {
      "default": 25,
      "description": "Cap on number of hits returned.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "pattern": {
      "description": "Regex pattern (or plain substring) to search within paragraph text. If the pattern doesn't compile as regex, falls back to literal substring match.",
      "maxLength": 200,
      "minLength": 2,
      "type": "string"
    },
    "slug": {
      "description": "TNA judgment slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'.",
      "minLength": 8,
      "type": "string"
    }
  },
  "required": [
    "slug",
    "pattern"
  ],
  "additionalProperties": false
}

legislation_search

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 ("the recent Renters' Rights Act"), query by phrase alone and read the year from the results — guessing a year and filtering by it zeroes results when wrong. For broader concept queries across content, set `fulltext=True`. Authoritative source for UK primary and secondary legislation (legislation.gov.uk).

Parameters5

fulltext	boolean	optional	Default false → searches Act/SI titles only (best for finding a named Act, e.g. 'Housing Act 1988' returns ukpga/1988/50 first). Set true to search the full text of every Act/SI for the query (returns SIs and regulations that cite the term — e.g. 'rental deposits' would return many implementing instruments).
limit	integer	optional	Maximum results to return (1–50). Passed to the upstream results-count param.
query	string	required	Search query, e.g. 'Housing Act 1988' or 'data protection personal data'
type	any	optional	Filter by type: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Exact-match — omit if you don't already know whether you're looking for an Act vs an SI.
year	any	optional	Filter by year of enactment (exact-match — a single integer, not a range). Omit unless you already know the Act's year. Speculating a year (e.g. 'this is recent so it must be 2026') and getting it wrong will zero out the result set. Better workflow: query without `year`, then read the year from the returned results.

Raw schema

{
  "type": "object",
  "properties": {
    "fulltext": {
      "default": false,
      "description": "Default false → searches Act/SI titles only (best for finding a named Act, e.g. 'Housing Act 1988' returns ukpga/1988/50 first). Set true to search the full text of every Act/SI for the query (returns SIs and regulations that cite the term — e.g. 'rental deposits' would return many implementing instruments).",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Maximum results to return (1–50). Passed to the upstream results-count param.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'Housing Act 1988' or 'data protection personal data'",
      "maxLength": 500,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by type: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Exact-match — omit if you don't already know whether you're looking for an Act vs an SI."
    },
    "year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1800,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by year of enactment (exact-match — a single integer, not a range). Omit unless you already know the Act's year. Speculating a year (e.g. 'this is recent so it must be 2026') and getting it wrong will zero out the result set. Better workflow: query without `year`, then read the year from the returned results."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

legislation_get_section

USE THIS TOOL WHEN you have a known Act / SI and want the parsed text of a specific section, with extent and in-force metadata. Returns full section text, territorial extent, in-force status, and prospective flag. Content capped per max_chars (default 10,000, ~2,500 tokens) — raise for unusually long definition sections; check content_truncated in the response. ALWAYS check `extent` — a section may apply to England & Wales but not Scotland or Northern Ireland. Reciting a section without checking extent is a recurring legal-research error. Alternative: call read_resource(uri="legislation://{type}/{year}/{number}/ section/{section}") for raw CLML XML; use this tool when you want the parsed structured response instead.

Parameters5

max_chars	integer	optional	Maximum characters of section content to return. Default 10,000 (~2,500 tokens) covers almost every section. Raise to 50,000+ only for unusually long Finance Act definition sections. Check content_truncated in the response to see if it was cut.
number	integer	required	Chapter or SI number
section	string	required	Section number, e.g. '47' or '12A'. Use the numeric part only — not 'section-47'. Schedules are not currently supported.
type	string	required	Legislation type code: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Use the value from legislation_search results.
year	integer	required	Year of enactment

Raw schema

{
  "type": "object",
  "properties": {
    "max_chars": {
      "default": 10000,
      "description": "Maximum characters of section content to return. Default 10,000 (~2,500 tokens) covers almost every section. Raise to 50,000+ only for unusually long Finance Act definition sections. Check content_truncated in the response to see if it was cut.",
      "maximum": 200000,
      "minimum": 500,
      "type": "integer"
    },
    "number": {
      "description": "Chapter or SI number",
      "minimum": 1,
      "type": "integer"
    },
    "section": {
      "description": "Section number, e.g. '47' or '12A'. Use the numeric part only — not 'section-47'. Schedules are not currently supported.",
      "maxLength": 50,
      "minLength": 1,
      "type": "string"
    },
    "type": {
      "description": "Legislation type code: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Use the value from legislation_search results.",
      "maxLength": 10,
      "minLength": 2,
      "type": "string"
    },
    "year": {
      "description": "Year of enactment",
      "maximum": 2100,
      "minimum": 1800,
      "type": "integer"
    }
  },
  "required": [
    "type",
    "year",
    "number",
    "section"
  ],
  "additionalProperties": false
}

legislation_get_toc

USE THIS TOOL WHEN you have a known Act / SI and want the structural table of contents (parts, chapters, sections, schedules). Returns structural elements with XML id and title, e.g. 'section-47: Definitions'. AFTER calling, pass the numeric section identifier (use '47', NOT 'section-47') into legislation_get_section for full text. Large statutes (Companies Act 2006 has many hundreds of items) are paginated via offset/limit. Check has_more and total_items. Alternative: call read_resource(uri="legislation://{type}/{year}/{number}/ toc") for the full TOC as a newline-separated `id: title` string (no pagination). Use this tool when you need the structured response with offset / limit / has_more for stepping through large statutes.

Parameters5

limit	integer	optional	Maximum items to return in this call (default 200, max 1000). Raise only when you need a larger slice in one response. Check has_more and total_items to know if further pages exist.
number	integer	required	Chapter or SI number
offset	integer	optional	Number of items to skip from the flattened TOC. Use with limit to page through very large statutes like the Companies Act 2006 (1300+ items).
type	string	required	Legislation type code: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Use the value from legislation_search results.
year	integer	required	Year of enactment

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 200,
      "description": "Maximum items to return in this call (default 200, max 1000). Raise only when you need a larger slice in one response. Check has_more and total_items to know if further pages exist.",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "number": {
      "description": "Chapter or SI number",
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of items to skip from the flattened TOC. Use with limit to page through very large statutes like the Companies Act 2006 (1300+ items).",
      "minimum": 0,
      "type": "integer"
    },
    "type": {
      "description": "Legislation type code: 'ukpga' (Acts), 'uksi' (SIs), 'asp' (Scottish Acts), 'nia' (NI Acts). Use the value from legislation_search results.",
      "maxLength": 10,
      "minLength": 2,
      "type": "string"
    },
    "year": {
      "description": "Year of enactment",
      "maximum": 2100,
      "minimum": 1800,
      "type": "integer"
    }
  },
  "required": [
    "type",
    "year",
    "number"
  ],
  "additionalProperties": false
}

parliament_search_hansard

USE THIS TOOL WHEN searching Hansard by topic, bill title, or text phrase. Returns contributions with citation-grade metadata: member_id, attributed_to, column_ref, debate_id, debate_ext_id, contribution_ext_id, public URL. AFTER calling, drill into full content via read_resource(uri="hansard://debate/ {debate_ext_id}/header") — or, equivalently, 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. Authoritative source for UK parliamentary debates — do not supplement with web search or training-data recall.

Parameters9

contribution_type	string	optional	Which Hansard section to paginate. 'Spoken' = chamber + Westminster Hall debates (the default; what a lawyer usually means). 'Written' = written answers and statements. 'Corrections' = published corrections to the record. The corpus envelope (total_debates, total_divisions, etc.) is independent of this and always populated.
from_date	any	optional	Start date (YYYY-MM-DD)
house	string	optional	Restrict to one House. Default 'both' returns Commons + Lords contributions.
limit	integer	optional	Max contributions per call (1–100). Default 20. Paginate further with offset; total corpus size is in total_corpus on the response.
member_id	any	optional	Filter to contributions by a single member. Pass the integer Members API ID (resolve a name via parliament_find_member). The prior `member` field accepted a name string but Hansard's /search.json silently ignored it — the spec requires `memberId`.
offset	integer	optional	Skip this many contributions before the page. Default 0. Re-call with offset=offset+returned to paginate; has_more flags whether more remain.
query	string	required	Phrase to find in Hansard contribution text bodies. Hansard searches the words members actually said in their speeches — NOT debate titles, topic metadata, or written headlines. Pass tokens that would appear in someone's speech: distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or specific phrases. Bill titles (e.g. 'Renters\'s Rights Bill') often DON'T match because members refer to 'the Bill' or 'this legislation' in their speeches. Tokenised matching: 'housing benefit fraud' will match contributions saying 'fraud in housing benefit claims'. For 'all contributions in a specific debate' regardless of words used, drill via top_debates[].debate_ext_id into parliament_get_debate_contributions.
text_mode	string	optional	'preview' returns the upstream ~250-char snippet (fast, low context cost). 'full' returns ContributionTextFull (still capped at 3000 chars). For full contribution text without the cap, read the resource hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.
to_date	any	optional	End date (YYYY-MM-DD)

Raw schema

{
  "type": "object",
  "properties": {
    "contribution_type": {
      "default": "Spoken",
      "description": "Which Hansard section to paginate. 'Spoken' = chamber + Westminster Hall debates (the default; what a lawyer usually means). 'Written' = written answers and statements. 'Corrections' = published corrections to the record. The corpus envelope (total_debates, total_divisions, etc.) is independent of this and always populated.",
      "enum": [
        "Spoken",
        "Written",
        "Corrections"
      ],
      "type": "string"
    },
    "from_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start date (YYYY-MM-DD)"
    },
    "house": {
      "default": "both",
      "description": "Restrict to one House. Default 'both' returns Commons + Lords contributions.",
      "enum": [
        "Commons",
        "Lords",
        "both"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Max contributions per call (1–100). Default 20. Paginate further with offset; total corpus size is in total_corpus on the response.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "member_id": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to contributions by a single member. Pass the integer Members API ID (resolve a name via parliament_find_member). The prior `member` field accepted a name string but Hansard's /search.json silently ignored it — the spec requires `memberId`."
    },
    "offset": {
      "default": 0,
      "description": "Skip this many contributions before the page. Default 0. Re-call with offset=offset+returned to paginate; has_more flags whether more remain.",
      "maximum": 5000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Phrase to find in Hansard contribution text bodies. Hansard searches the words members actually said in their speeches — NOT debate titles, topic metadata, or written headlines. Pass tokens that would appear in someone's speech: distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or specific phrases. Bill titles (e.g. 'Renters\\'s Rights Bill') often DON'T match because members refer to 'the Bill' or 'this legislation' in their speeches. Tokenised matching: 'housing benefit fraud' will match contributions saying 'fraud in housing benefit claims'. For 'all contributions in a specific debate' regardless of words used, drill via top_debates[].debate_ext_id into parliament_get_debate_contributions.",
      "maxLength": 500,
      "minLength": 1,
      "type": "string"
    },
    "text_mode": {
      "default": "preview",
      "description": "'preview' returns the upstream ~250-char snippet (fast, low context cost). 'full' returns ContributionTextFull (still capped at 3000 chars). For full contribution text without the cap, read the resource hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.",
      "enum": [
        "preview",
        "full"
      ],
      "type": "string"
    },
    "to_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End date (YYYY-MM-DD)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

parliament_policy_position_summary

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.

Parameters5

from_date	any	optional	Start date (YYYY-MM-DD)
house	string	optional	Restrict to one House. Default 'both'.
max_debates_scanned	integer	optional	Hard cap on debates sampled from /search/Debates.json to compute facets. Default 200 issues ≤4 upstream calls (take=50 each). Raise to 2000 (≤40 calls) for an exhaustive sweep on a heavily-debated topic. Hansard rate limit: 1000 req/5min.
to_date	any	optional	End date (YYYY-MM-DD)
topic	string	required	Phrase to find in Hansard contribution text bodies for the facet aggregation. Same semantics as parliament_search_hansard.query: tokens that appear in members' actual speeches, not bill titles or topic metadata. The aggregator sweeps top_debates[] returned by /search/Debates.json — those debates are matched on the phrase appearing in titles or contribution text, so passing a Bill title (e.g. 'Renters\' Rights Bill') usually works for THIS tool even though it wouldn't for member-level text search, because debate-level matching uses metadata in addition to body text.

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start date (YYYY-MM-DD)"
    },
    "house": {
      "default": "both",
      "description": "Restrict to one House. Default 'both'.",
      "enum": [
        "Commons",
        "Lords",
        "both"
      ],
      "type": "string"
    },
    "max_debates_scanned": {
      "default": 200,
      "description": "Hard cap on debates sampled from /search/Debates.json to compute facets. Default 200 issues ≤4 upstream calls (take=50 each). Raise to 2000 (≤40 calls) for an exhaustive sweep on a heavily-debated topic. Hansard rate limit: 1000 req/5min.",
      "maximum": 2000,
      "minimum": 50,
      "type": "integer"
    },
    "to_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End date (YYYY-MM-DD)"
    },
    "topic": {
      "description": "Phrase to find in Hansard contribution text bodies for the facet aggregation. Same semantics as parliament_search_hansard.query: tokens that appear in members' actual speeches, not bill titles or topic metadata. The aggregator sweeps top_debates[] returned by /search/Debates.json — those debates are matched on the phrase appearing in titles or contribution text, so passing a Bill title (e.g. 'Renters\\' Rights Bill') usually works for THIS tool even though it wouldn't for member-level text search, because debate-level matching uses metadata in addition to body text.",
      "maxLength": 200,
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false
}

parliament_find_member

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).

Parameters1

name

string

required

Name or partial name, e.g. 'Starmer', 'Baroness Hale'

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Name or partial name, e.g. 'Starmer', 'Baroness Hale'",
      "maxLength": 200,
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

parliament_member_debates

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.

Parameters4

limit	integer	optional	Maximum contributions to return. Default 20.
member_id	integer	required	Parliament Members API integer ID. Obtain from parliament_find_member.
offset	integer	optional	Number of contributions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.
topic	any	optional	Optional phrase to find in THIS member's contribution text bodies. Hansard searches the words the member actually said, NOT the topic or title of the debate. Pass tokens this member would have spoken — distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or motion numbers ('Motion C1') — not the bill's name (members rarely say e.g. 'Renters\' Rights Bill' verbatim in their speeches). If you want 'every contribution this member made in a specific debate' regardless of words used, find the debate_ext_id then use parliament_get_debate_contributions(debate_ext_id, member_id=...).

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum contributions to return. Default 20.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "member_id": {
      "description": "Parliament Members API integer ID. Obtain from parliament_find_member.",
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of contributions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.",
      "maximum": 2000,
      "minimum": 0,
      "type": "integer"
    },
    "topic": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional phrase to find in THIS member's contribution text bodies. Hansard searches the words the member actually said, NOT the topic or title of the debate. Pass tokens this member would have spoken — distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or motion numbers ('Motion C1') — not the bill's name (members rarely say e.g. 'Renters\\' Rights Bill' verbatim in their speeches). If you want 'every contribution this member made in a specific debate' regardless of words used, find the debate_ext_id then use parliament_get_debate_contributions(debate_ext_id, member_id=...)."
    }
  },
  "required": [
    "member_id"
  ],
  "additionalProperties": false
}

parliament_member_interests

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.

Parameters5

category	any	optional	Filter by interest category. Common categories: 'donations' (donations and support), 'gifts_uk' (gifts/hospitality from UK), 'employment' (employment and earnings), 'land' (land and property), 'shareholdings', 'overseas_visits'. Omit for all categories.
limit	integer	optional	Max interests per call. Hard-capped at 20 by the upstream interests-api.parliament.uk (verified live 2026-05-29: Take=100 still returns 20). For prolific members, paginate via offset; total size is in totalResults on the response.
max_description_chars	integer	optional	Per-entry cap on the free-text description field. Default 500 prevents context blow-up on members with lengthy donation or directorship narratives. Raise to 2000+ only for forensic provenance work.
member_id	integer	required	Parliament Members API integer ID. Get from parliament_find_member.
offset	integer	optional	Number of interests to skip before this page. Default 0 for the first page. To paginate prolific members (100+ interests), re-call with offset=offset+returned while the previous response had has_more=true.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "enum": [
            "employment",
            "employment_adhoc",
            "employment_ongoing",
            "donations",
            "gifts_uk",
            "overseas_visits",
            "gifts_overseas",
            "land",
            "shareholdings",
            "miscellaneous",
            "family_employed",
            "family_lobbying"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by interest category. Common categories: 'donations' (donations and support), 'gifts_uk' (gifts/hospitality from UK), 'employment' (employment and earnings), 'land' (land and property), 'shareholdings', 'overseas_visits'. Omit for all categories."
    },
    "limit": {
      "default": 20,
      "description": "Max interests per call. Hard-capped at 20 by the upstream interests-api.parliament.uk (verified live 2026-05-29: Take=100 still returns 20). For prolific members, paginate via offset; total size is in totalResults on the response.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "max_description_chars": {
      "default": 500,
      "description": "Per-entry cap on the free-text description field. Default 500 prevents context blow-up on members with lengthy donation or directorship narratives. Raise to 2000+ only for forensic provenance work.",
      "maximum": 5000,
      "minimum": 50,
      "type": "integer"
    },
    "member_id": {
      "description": "Parliament Members API integer ID. Get from parliament_find_member.",
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of interests to skip before this page. Default 0 for the first page. To paginate prolific members (100+ interests), re-call with offset=offset+returned while the previous response had has_more=true.",
      "maximum": 500,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "member_id"
  ],
  "additionalProperties": false
}

parliament_search_petitions

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).

Parameters4

limit	integer	optional	Maximum petitions to return. Default 20.
offset	integer	optional	Number of petitions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.
query	string	required	Search term for petition titles, e.g. 'ban trophy hunting' or 'NHS funding'.
state	string	optional	Filter by petition state.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum petitions to return. Default 20.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of petitions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.",
      "maximum": 2000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Search term for petition titles, e.g. 'ban trophy hunting' or 'NHS funding'.",
      "maxLength": 300,
      "minLength": 2,
      "type": "string"
    },
    "state": {
      "default": "all",
      "description": "Filter by petition state.",
      "enum": [
        "open",
        "closed",
        "all"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

parliament_get_debate_divisions

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, pass `votes_id` as `division_id` into 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.

Parameters1

debate_ext_id

string

required

Debate GUID (DebateSectionExtId). Chain from parliament_search_hansard contribution.debate_ext_id, top_debates[].debate_ext_id, or parliament_policy_position_summary top_debates[].debate_ext_id.

Raw schema

{
  "type": "object",
  "properties": {
    "debate_ext_id": {
      "description": "Debate GUID (DebateSectionExtId). Chain from parliament_search_hansard contribution.debate_ext_id, top_debates[].debate_ext_id, or parliament_policy_position_summary top_debates[].debate_ext_id.",
      "minLength": 8,
      "type": "string"
    }
  },
  "required": [
    "debate_ext_id"
  ],
  "additionalProperties": false
}

parliament_get_debate_contributions

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.

Parameters2

debate_ext_id	string	required	Debate GUID (DebateSectionExtId). Chain from parliament_search_hansard top_debates[].debate_ext_id, parliament_lookup_by_column matches[].debate_ext_id, or any tool that surfaces a debate identifier.
member_id	any	optional	Optional integer Members API ID. When given, only that member's contributions in this debate are returned — regardless of which words they used. Resolves via parliament_find_member. When omitted, every contribution in the debate is returned (typical debate: 100-200 items).

Raw schema

{
  "type": "object",
  "properties": {
    "debate_ext_id": {
      "description": "Debate GUID (DebateSectionExtId). Chain from parliament_search_hansard top_debates[].debate_ext_id, parliament_lookup_by_column matches[].debate_ext_id, or any tool that surfaces a debate identifier.",
      "minLength": 8,
      "type": "string"
    },
    "member_id": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional integer Members API ID. When given, only that member's contributions in this debate are returned — regardless of which words they used. Resolves via parliament_find_member. When omitted, every contribution in the debate is returned (typical debate: 100-200 items)."
    }
  },
  "required": [
    "debate_ext_id"
  ],
  "additionalProperties": false
}

parliament_lookup_by_column

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 Items - `source` / `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.

Parameters3

column_number	string	required	Hansard column number from an OSCOLA footnote, e.g. '200' for 'HL Deb 14 Oct 2025, vol 849, col 200'. String (not integer) to accommodate column suffixes like '1162W' for written answers.
house	string	optional	Restrict to one House. Default 'both' searches across both Houses.
volume_number	integer	required	Hansard volume number (the 'vol 849' part of an OSCOLA citation). Required — the endpoint only resolves citations when given the volume; sitting date is NOT a substitute (verified live 2026-05-29).

Raw schema

{
  "type": "object",
  "properties": {
    "column_number": {
      "description": "Hansard column number from an OSCOLA footnote, e.g. '200' for 'HL Deb 14 Oct 2025, vol 849, col 200'. String (not integer) to accommodate column suffixes like '1162W' for written answers.",
      "maxLength": 20,
      "minLength": 1,
      "type": "string"
    },
    "house": {
      "default": "both",
      "description": "Restrict to one House. Default 'both' searches across both Houses.",
      "enum": [
        "Commons",
        "Lords",
        "both"
      ],
      "type": "string"
    },
    "volume_number": {
      "description": "Hansard volume number (the 'vol 849' part of an OSCOLA citation). Required — the endpoint only resolves citations when given the volume; sitting date is NOT a substitute (verified live 2026-05-29).",
      "exclusiveMinimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "column_number",
    "volume_number"
  ],
  "additionalProperties": false
}

bills_search_bills

USE THIS TOOL WHEN searching UK parliamentary bills by keyword, session, house, or legislative stage. Returns a paginated page of bill summaries (title, 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.

Parameters6

house	any	optional	Filter by originating house. Omit for all houses.
limit	integer	optional	Maximum bills to return in this call. Default 20 keeps responses focused; raise up to 100 for bulk exports.
offset	integer	optional	Number of results to skip before this page. Default 0 for the first page. Re-call with offset=offset+returned while has_more is true to paginate.
query	string	required	Search term for bill titles and descriptions, e.g. 'online safety' or 'financial services'.
session	any	optional	Numeric parliamentary session ID (e.g. 40 = 2024-25, 39 = 2023-24). NOT a year string like '2025'. If you only know the year, omit this and filter the results instead. Omit to search all sessions.
stage	any	optional	Filter by current legislative stage.

Raw schema

{
  "type": "object",
  "properties": {
    "house": {
      "anyOf": [
        {
          "enum": [
            "Commons",
            "Lords",
            "All"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by originating house. Omit for all houses."
    },
    "limit": {
      "default": 20,
      "description": "Maximum bills to return in this call. Default 20 keeps responses focused; raise up to 100 for bulk exports.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip before this page. Default 0 for the first page. Re-call with offset=offset+returned while has_more is true to paginate.",
      "maximum": 2000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Search term for bill titles and descriptions, e.g. 'online safety' or 'financial services'.",
      "maxLength": 500,
      "minLength": 1,
      "type": "string"
    },
    "session": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Numeric parliamentary session ID (e.g. 40 = 2024-25, 39 = 2023-24). NOT a year string like '2025'. If you only know the year, omit this and filter the results instead. Omit to search all sessions."
    },
    "stage": {
      "anyOf": [
        {
          "enum": [
            "firstreading",
            "secondreading",
            "committee",
            "report",
            "thirdreading",
            "royalassent"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by current legislative stage."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

bills_get_bill

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.

Parameters2

bill_id	integer	required	Bill ID from bills_search_bills results.
max_summary_chars	integer	optional	Maximum characters of the bill summary text to return. Default 5,000 (~1,250 tokens) covers most bills. Raise for substantive government bills (Finance Act, Levelling-up) whose summary runs longer. Check summary_truncated in the response to see if it was cut.

Raw schema

{
  "type": "object",
  "properties": {
    "bill_id": {
      "description": "Bill ID from bills_search_bills results.",
      "minimum": 1,
      "type": "integer"
    },
    "max_summary_chars": {
      "default": 5000,
      "description": "Maximum characters of the bill summary text to return. Default 5,000 (~1,250 tokens) covers most bills. Raise for substantive government bills (Finance Act, Levelling-up) whose summary runs longer. Check summary_truncated in the response to see if it was cut.",
      "maximum": 50000,
      "minimum": 500,
      "type": "integer"
    }
  },
  "required": [
    "bill_id"
  ],
  "additionalProperties": false
}

votes_search_divisions

USE THIS TOOL WHEN searching Commons or Lords formal votes by topic, date, or member. Returns division summaries (title, date, vote counts, pass/fail). 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.

Parameters7

from_date	any	optional	Start date (YYYY-MM-DD).
house	string	optional	Which house to search.
limit	integer	optional	Maximum divisions to return. Default 25 (Commons API max-per-page).
member_id	any	optional	Filter to divisions where this member voted. Get the member ID from parliament_find_member.
offset	integer	optional	Number of divisions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.
query	any	optional	Search term for division titles, e.g. 'Rwanda' or 'Online Safety Bill'. Omit to browse recent divisions.
to_date	any	optional	End date (YYYY-MM-DD).

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start date (YYYY-MM-DD)."
    },
    "house": {
      "default": "Commons",
      "description": "Which house to search.",
      "enum": [
        "Commons",
        "Lords"
      ],
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "Maximum divisions to return. Default 25 (Commons API max-per-page).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "member_id": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to divisions where this member voted. Get the member ID from parliament_find_member."
    },
    "offset": {
      "default": 0,
      "description": "Number of divisions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.",
      "maximum": 2000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "anyOf": [
        {
          "maxLength": 500,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search term for division titles, e.g. 'Rwanda' or 'Online Safety Bill'. Omit to browse recent divisions."
    },
    "to_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End date (YYYY-MM-DD)."
    }
  },
  "additionalProperties": false
}

votes_get_division

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).

Parameters2

division_id	integer	required	Division ID from votes_search_divisions results.
house	string	optional	Which house this division belongs to.

Raw schema

{
  "type": "object",
  "properties": {
    "division_id": {
      "description": "Division ID from votes_search_divisions results.",
      "minimum": 1,
      "type": "integer"
    },
    "house": {
      "default": "Commons",
      "description": "Which house this division belongs to.",
      "enum": [
        "Commons",
        "Lords"
      ],
      "type": "string"
    }
  },
  "required": [
    "division_id"
  ],
  "additionalProperties": false
}

committees_search_committees

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.

Parameters4

active_only	boolean	optional	If true, only return currently active committees.
house	any	optional	Filter by house.
limit	integer	optional	Maximum committees to return. Default 100 comfortably covers all currently-active UK select committees. Raise only for historical sweeps.
query	any	optional	Search term for committee names, e.g. 'defence' or 'treasury'. Filtered client-side against committee names. Omit to list all committees.

Raw schema

{
  "type": "object",
  "properties": {
    "active_only": {
      "default": true,
      "description": "If true, only return currently active committees.",
      "type": "boolean"
    },
    "house": {
      "anyOf": [
        {
          "enum": [
            "Commons",
            "Lords",
            "Joint"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by house."
    },
    "limit": {
      "default": 100,
      "description": "Maximum committees to return. Default 100 comfortably covers all currently-active UK select committees. Raise only for historical sweeps.",
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "anyOf": [
        {
          "maxLength": 300,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search term for committee names, e.g. 'defence' or 'treasury'. Filtered client-side against committee names. Omit to list all committees."
    }
  },
  "additionalProperties": false
}

committees_get_committee

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.

Parameters1

committee_id

integer

required

Committee ID from committees_search_committees results.

Raw schema

{
  "type": "object",
  "properties": {
    "committee_id": {
      "description": "Committee ID from committees_search_committees results.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "committee_id"
  ],
  "additionalProperties": false
}

committees_search_evidence

USE THIS TOOL WHEN you have a committee_id and want the oral and written evidence submitted to it. Returns ONE PAGE of evidence (default 20). Free-text titles are capped per max_title_chars; witness lists are capped at 10 per item. For committees with many submissions, re-call with offset=offset+returned while has_more is true. Authoritative source for parliamentary committee evidence.

Parameters5

committee_id	integer	required	Committee ID from committees_search_committees results.
evidence_type	string	optional	Type of evidence to search.
limit	integer	optional	Maximum evidence items to return. Default 20. When evidence_type='both' the limit is split across oral and written (roughly half each).
max_title_chars	integer	optional	Per-item cap on the free-text title field. Default 300 prevents context blow-up from verbose inquiry titles. Raise to 1000+ only when you need the full title text.
offset	integer	optional	Number of evidence items to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.

Raw schema

{
  "type": "object",
  "properties": {
    "committee_id": {
      "description": "Committee ID from committees_search_committees results.",
      "minimum": 1,
      "type": "integer"
    },
    "evidence_type": {
      "default": "both",
      "description": "Type of evidence to search.",
      "enum": [
        "oral",
        "written",
        "both"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum evidence items to return. Default 20. When evidence_type='both' the limit is split across oral and written (roughly half each).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "max_title_chars": {
      "default": 300,
      "description": "Per-item cap on the free-text title field. Default 300 prevents context blow-up from verbose inquiry titles. Raise to 1000+ only when you need the full title text.",
      "maximum": 2000,
      "minimum": 50,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Number of evidence items to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true.",
      "maximum": 2000,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "committee_id"
  ],
  "additionalProperties": false
}

citations_parse

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.

Parameters2

disambiguate	boolean	optional	Default False — pure-regex parsing, no model in the loop. If True, ambiguous citations (e.g. bare EWHC without a division) are sent to the connected client's own LLM, via MCP sampling, to resolve the division. Opt in only when you want best-effort division resolution and accept that a model shapes the result.
text	string	required	Free text containing OSCOLA citations to extract. Supported: 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). Max 50,000 chars.

Raw schema

{
  "type": "object",
  "properties": {
    "disambiguate": {
      "default": false,
      "description": "Default False — pure-regex parsing, no model in the loop. If True, ambiguous citations (e.g. bare EWHC without a division) are sent to the connected client's own LLM, via MCP sampling, to resolve the division. Opt in only when you want best-effort division resolution and accept that a model shapes the result.",
      "type": "boolean"
    },
    "text": {
      "description": "Free text containing OSCOLA citations to extract. Supported: 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). Max 50,000 chars.",
      "maxLength": 50000,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

citations_resolve

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.

Parameters1

citation

string

required

A single OSCOLA citation to parse and resolve. E.g. '[2024] UKSC 12', 'SI 2018/1234', 's.47 Companies Act 2006'

Raw schema

{
  "type": "object",
  "properties": {
    "citation": {
      "description": "A single OSCOLA citation to parse and resolve. E.g. '[2024] UKSC 12', 'SI 2018/1234', 's.47 Companies Act 2006'",
      "maxLength": 500,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "citation"
  ],
  "additionalProperties": false
}

citations_network

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.

Parameters1

case_uri

string

required

TNA judgment URI slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'. Use the 'uri' field from case_law_search results — not the full URL. Do not include the 'https://caselaw.nationalarchives.gov.uk/' prefix.

Raw schema

{
  "type": "object",
  "properties": {
    "case_uri": {
      "description": "TNA judgment URI slug, e.g. 'uksc/2024/12' or 'ewca/civ/2023/450'. Use the 'uri' field from case_law_search results — not the full URL. Do not include the 'https://caselaw.nationalarchives.gov.uk/' prefix.",
      "minLength": 5,
      "type": "string"
    }
  },
  "required": [
    "case_uri"
  ],
  "additionalProperties": false
}

citations_format_oscola

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).

Parameters14

citation_type	string	required	'type' field from citations_resolve result.
confidence	number	required	'confidence' from citations_resolve. Refuses to format if 0.0 — that means TNA confirmed the document does not exist. Pass only the value citations_resolve returned; do not guess.
court	any	optional	'court' from citations_resolve, e.g. 'UKSC', 'EWCA CIV', 'EWHC (KB)'.
legislation_title	any	optional	'legislation_title' from citations_resolve, e.g. 'Companies Act 2006'.
number	any	optional	'number' from citations_resolve (judgment number within the year).
page	any	optional	'page' from citations_resolve (starting page in the law report).
raw	any	optional	'raw' from citations_resolve. Used as-is for EU retained law — the original text preserves the Regulation/Directive distinction.
report_series	any	optional	'report_series' from citations_resolve, e.g. 'WLR', 'AC', 'QB'.
resolved_url	any	optional	'resolved_url' from citations_resolve. Must be non-null for neutral citations.
section	any	optional	'section' from citations_resolve, e.g. '47', '12', '20A'.
si_number	any	optional	'si_number' from citations_resolve.
si_year	any	optional	'si_year' from citations_resolve.
volume	any	optional	'volume' from citations_resolve (law report volume, if any).
year	any	optional	'year' from citations_resolve.

Raw schema

{
  "type": "object",
  "properties": {
    "citation_type": {
      "description": "'type' field from citations_resolve result.",
      "enum": [
        "neutral",
        "law_report",
        "legislation",
        "si",
        "eu_retained"
      ],
      "type": "string"
    },
    "confidence": {
      "description": "'confidence' from citations_resolve. Refuses to format if 0.0 — that means TNA confirmed the document does not exist. Pass only the value citations_resolve returned; do not guess.",
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "court": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'court' from citations_resolve, e.g. 'UKSC', 'EWCA CIV', 'EWHC (KB)'."
    },
    "legislation_title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'legislation_title' from citations_resolve, e.g. 'Companies Act 2006'."
    },
    "number": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'number' from citations_resolve (judgment number within the year)."
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'page' from citations_resolve (starting page in the law report)."
    },
    "raw": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'raw' from citations_resolve. Used as-is for EU retained law — the original text preserves the Regulation/Directive distinction."
    },
    "report_series": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'report_series' from citations_resolve, e.g. 'WLR', 'AC', 'QB'."
    },
    "resolved_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'resolved_url' from citations_resolve. Must be non-null for neutral citations."
    },
    "section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'section' from citations_resolve, e.g. '47', '12', '20A'."
    },
    "si_number": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'si_number' from citations_resolve."
    },
    "si_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'si_year' from citations_resolve."
    },
    "volume": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'volume' from citations_resolve (law report volume, if any)."
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "'year' from citations_resolve."
    }
  },
  "required": [
    "citation_type",
    "confidence"
  ],
  "additionalProperties": false
}

hmrc_get_vat_rate

USE THIS TOOL WHEN you have a UK commodity or service description and want its VAT rate category. Returns the rate (standard 20%, reduced 5%, zero 0%, exempt), effective date, and any relevant conditions or exceptions. IMPORTANT: Uses a static lookup table current as of 22 Nov 2023 (Autumn Statement). Rates may have changed in subsequent Budgets — for time-sensitive advice, verify against GOV.UK via hmrc_search_guidance.

Parameters1

commodity_code

string

required

Commodity code or plain-English description. E.g. 'food', 'domestic fuel', 'software', 'financial services', 'new build residential'

Raw schema

{
  "type": "object",
  "properties": {
    "commodity_code": {
      "description": "Commodity code or plain-English description. E.g. 'food', 'domestic fuel', 'software', 'financial services', 'new build residential'",
      "maxLength": 200,
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "commodity_code"
  ],
  "additionalProperties": false
}

hmrc_check_mtd_status

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.

Parameters1

vrn

string

required

VAT Registration Number: 9 digits, e.g. '123456789'. GB prefix accepted and stripped automatically.

Raw schema

{
  "type": "object",
  "properties": {
    "vrn": {
      "description": "VAT Registration Number: 9 digits, e.g. '123456789'. GB prefix accepted and stripped automatically.",
      "maxLength": 12,
      "minLength": 9,
      "type": "string"
    }
  },
  "required": [
    "vrn"
  ],
  "additionalProperties": false
}

hmrc_search_guidance

USE THIS TOOL WHEN searching GOV.UK for HMRC tax guidance on a topic (VAT, income tax, corporation tax, etc.). Returns matching guidance titles, URLs, summaries, and last-updated dates. Searches the official GOV.UK content API filtered to HMRC publications. Authoritative source for current HMRC tax guidance. Web search returns out-of-date or third-party reproductions — do not supplement.

Parameters2

limit	integer	optional	Maximum guidance results to return (1–25). Passed to the GOV.UK search count param.
query	string	required	Search query for HMRC guidance, e.g. 'VAT digital services', 'R&D tax relief SME'

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Maximum guidance results to return (1–25). Passed to the GOV.UK search count param.",
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Search query for HMRC guidance, e.g. 'VAT digital services', 'R&D tax relief SME'",
      "maxLength": 300,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

list_prompts

List all available prompts. Returns JSON with prompt metadata including name, description, and optional arguments.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_prompt

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.

Parameters2

arguments	any	optional	Optional arguments for the prompt
name	string	required	The name of the prompt to get

Raw schema

{
  "type": "object",
  "properties": {
    "arguments": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional arguments for the prompt"
    },
    "name": {
      "description": "The name of the prompt to get",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

list_resources

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}.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

read_resource

Read a resource by its URI. For static resources, provide the exact URI. For templated resources, provide the URI with template parameters filled in. Returns the resource content as a string. Binary content is base64-encoded.

Parameters1

uri

string

required

The URI of the resource to read

Raw schema

{
  "type": "object",
  "properties": {
    "uri": {
      "description": "The URI of the resource to read",
      "type": "string"
    }
  },
  "required": [
    "uri"
  ],
  "additionalProperties": false
}

README.md7 KBView on GitHub

uk-legal-mcp

smithery badge

UK legal research sources for your AI assistant.

uk-legal-mcp connects ChatGPT, Claude, VS Code, Cursor, and other MCP-aware clients to UK case law, legislation, Hansard, bills, votes, committees, OSCOLA citation parsing, and HMRC guidance. It returns primary source text and citation metadata so your agent can build evidence packs you can check and footnote.

No API keys are required for the legal sources. HMRC's authenticated Making Tax Digital endpoint is optional.

For best results, tell your assistant to use the uk-legal-mcp server and not to answer from memory when a UK legal source can be checked.

Quick Start

Use the hosted MCP endpoint:

text

https://uk-legal-mcp.fly.dev/mcp

For clients that use mcpServers JSON:

json

{
  "mcpServers": {
    "uk-legal": {
      "type": "http",
      "url": "https://uk-legal-mcp.fly.dev/mcp"
    }
  }
}

For local stdio use:

bash

uvx uk-legal-mcp

Claude Desktop local config:

json

{
  "mcpServers": {
    "uk-legal": {
      "command": "uvx",
      "args": ["uk-legal-mcp"]
    }
  }
}

If a hosted tool stops responding, refresh the server from your client's Apps / Customise menu. For very large Acts, local mode can be more reliable because it uses your own IP rather than a shared cloud IP.

Try This First

After connecting the server, start a fresh chat and ask:

text

I am checking a UK legal source. Only use uk-legal-mcp. Find the source, give me the source URL, and tell me what metadata I should check before relying on it.

For legal work, ask for an evidence pack rather than a bare answer:

text

Only use uk-legal-mcp. Give me the source text or source summary, the source URL, citation metadata, and any caveats about jurisdiction, version, or uncertainty.

See the lawyer guide for ready-to-run prompts.

What It Covers

Source area	What your assistant can check
Case law	UK judgments from TNA Find Case Law, including neutral citations, court, date, judgment metadata, paragraph reads, and in-judgment search.
Legislation	Acts and Statutory Instruments from legislation.gov.uk, including tables of contents, sections, territorial extent, in-force signals, and point-in-time reads.
Parliament	Hansard debates and contributions, debate-to-division chains, member biographies, column references, and petitions.
Bills	Parliamentary Bills, stages, sponsors, publications, and bill history.
Votes	Commons and Lords divisions, counts, results, and per-member voting records.
Committees	Select committees, memberships, oral evidence, and written evidence.
Citations	OSCOLA-style citation parsing and resolution to canonical sources.
HMRC	VAT rate lookups, GOV.UK HMRC guidance search, and optional authenticated MTD VAT status checks.

The server also exposes judgment://, legislation://, and hansard:// resources for source text that is too large to return in a single search result.

Full details are in the tool reference and upstream API reference.

Examples

Legislation check: the assistant finds the Worker Protection Act duty, commencement position, territorial extent, and source links.

ChatGPT answer using uk-legal-mcp to summarise the Worker Protection Act duty, commencement, territorial extent, and source links

Parliamentary evidence: the assistant follows a House of Lords debate into a division result for an Automated Vehicles Bill amendment.

ChatGPT answer using uk-legal-mcp to connect an Automated Vehicles Bill Hansard debate to the division result for Lord Liddle's Amendment 28

More examples are in the lawyer guide.

Using It Safely

uk-legal-mcp helps your AI assistant find and quote UK legal sources. It does not replace legal judgement.

Check jurisdiction. Legislation can apply differently in England, Wales, Scotland, and Northern Ireland. When reading a section, check the extent field before relying on it.
Check whether a provision is current. Some sections may be repealed, amended, prospective, or not yet in force. The server returns in-force and version-date information where the source provides it.
Verify citations before relying on them. Ask the agent to resolve case citations and Hansard volume/column references against the primary source.
Separate exact matches from nearby candidates. Case names and party names can be similar. A good answer should say which source was verified and which candidates were merely related.
Treat the result as an evidence pack. The server returns primary source text and citation metadata. Your agent can summarise it, but you decide how the law applies.

For Developers

Run the streamable HTTP server locally:

bash

python -m src.gateway

Run the declarative FastMCP manifest for inspection/dev tooling:

bash

fastmcp run
fastmcp inspect

fastmcp run is for inspection/dev only — it wraps the FastMCP runner directly and skips the production uvicorn shape (_HttpGuard, _AcceptNormalizer, proxy_headers) that python -m src.gateway wires for the Fly deployment. The _HttpGuard GET-SSE shim is required by claude.ai's web connector, so use python -m src.gateway for anything prod-like.

Use a local checkout over stdio:

json

{
  "mcpServers": {
    "local-uk-legal": {
      "command": "uv",
      "args": ["run", "--project", "<abs-path>", "uk-legal-mcp"],
      "env": { "VIRTUAL_ENV": "" }
    }
  }
}

Release notes live in CHANGELOG.md.

Install

Tools (35)

judgment_get_headerjudgment_get_indexjudgment_get_paragraphcase_law_searchcase_law_grep_judgmentlegislation_searchlegislation_get_sectionlegislation_get_toc

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "uk-legal-mcp": {
      "command": "uvx",
      "args": [
        "uk-legal-mcp"
      ]
    }
  }
}

io.github.paulieb89/uk-legal-mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

judgment_get_header

judgment_get_index

judgment_get_paragraph

case_law_search

case_law_grep_judgment

legislation_search

legislation_get_section

legislation_get_toc

parliament_search_hansard

parliament_policy_position_summary

parliament_find_member

parliament_member_debates

parliament_member_interests

parliament_search_petitions

parliament_get_debate_divisions

parliament_get_debate_contributions

parliament_lookup_by_column

bills_search_bills

bills_get_bill

votes_search_divisions

votes_get_division

committees_search_committees

committees_get_committee

committees_search_evidence

citations_parse

citations_resolve

citations_network

citations_format_oscola

hmrc_get_vat_rate

hmrc_check_mtd_status

hmrc_search_guidance

list_prompts

get_prompt

list_resources

read_resource

uk-legal-mcp

Quick Start

Try This First

What It Covers

Examples

Using It Safely

For Developers

Install

Related servers