# uk-legal

A Model Context Protocol server for UK legal research. Connects AI assistants to case law, legislation, parliamentary debates, bills, votes, committees, OSCOLA citation parsing, and HMRC tax data.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add bouch/uk-legal

# Browse available tools
npx -y smithery tool list bouch/uk-legal

# Get full schema for a tool
npx -y smithery tool get bouch/uk-legal judgment_get_header

# Call a tool
npx -y smithery tool call bouch/uk-legal judgment_get_header '{}'
```

## Direct MCP Connection

Endpoint: `https://uk-legal--bouch.run.tools`

## Tools (29)

- `judgment_get_header` — Get metadata for a UK court judgment: parties, judges, neutral citation, court, dates.
- `judgment_get_index` — Get the paragraph navigation index for a UK court judgment.
- `judgment_get_paragraph` — Get a single paragraph from a UK court judgment by its LegalDocML eId.
- `case_law_search` — Search UK case law via the TNA Find Case Law API.
- `case_law_grep_judgment` — Find paragraphs in a single judgment whose text matches a pattern.
- `legislation_search` — Search UK legislation on legislation.gov.uk.
- `legislation_get_section` — Retrieve a specific section of a UK Act or Statutory Instrument.
- `legislation_get_toc` — Retrieve the table of contents for a UK Act or SI.
- `parliament_search_hansard` — Search Hansard for parliamentary debates, questions, and speeches.
- `parliament_vibe_check` — Assess the likely parliamentary reception of a policy proposal.
- `parliament_find_member` — Search for a current or former MP or Lord by name.
- `parliament_member_debates` — Retrieve Hansard contributions by a specific member, optionally filtered by topic.
- `parliament_member_interests` — Look up registered financial interests for a member of Parliament.
- `parliament_search_petitions` — Search UK Parliament petitions by keyword.
- `bills_search_bills` — Search UK parliamentary bills by keyword, session, house, or legislative stage.
- `bills_get_bill` — Get full detail for a specific parliamentary bill.
- `votes_search_divisions` — Search parliamentary divisions (votes) in the Commons or Lords.
- `votes_get_division` — Get full detail for a parliamentary division including how each member voted.
- `committees_search_committees` — Search or list UK parliamentary select committees.
- `committees_get_committee` — Get detail for a parliamentary committee including current membership.
- `committees_search_evidence` — Search oral and written evidence submitted to a parliamentary committee.
- `citations_parse` — Extract and classify all OSCOLA legal citations from free text.
- `citations_resolve` — Parse and resolve a single OSCOLA citation to its canonical URL.
- `citations_network` — Map all citations within a judgment — cases cited, legislation referenced, SIs, EU law.
- `hmrc_get_vat_rate` — Look up the UK VAT rate for a commodity or service type.
- `hmrc_check_mtd_status` — Check a business's Making Tax Digital VAT mandate status via the HMRC API.
- `hmrc_search_guidance` — Search GOV.UK for HMRC tax guidance documents.
- `list_prompts` — List all available prompts.
- `get_prompt` — Get a prompt by name with optional arguments.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get bouch/uk-legal <tool-name>
```

## Prompts (4)

- `legislation_summarise_act` (type, year, number) — Summarise a UK Act of Parliament or Statutory Instrument.
- `legislation_compare_legislation` (type1, year1, number1, type2, year2, number2, topic) — Compare two pieces of UK legislation on a specific topic.
- `parliament_policy_vibe_check` (policy_description) — Assess the likely parliamentary reception of a policy proposal.
- `parliament_member_position_analysis` (member_name, topic) — Analyse a specific parliamentarian's stated position on a topic.
