legislation_get_section
Retrieve a specific section of a UK Act or Statutory Instrument.
Returns the full section text, territorial extent, in-force status,
and prospective flag. Content is capped per max_chars (default 10,000,
~2,500 tokens) — raise max_chars for unusually long definition
sections. Check content_truncated in the response to see if it was cut.
IMPORTANT: Always check `extent` — a section may apply to England &
Wales but not Scotland or Northern Ireland.
Alternative: read the resource template
`legislation://{type}/{year}/{number}/section/{section}` to get raw
CLML XML directly. Use this tool when you want the parsed structured
response (extent, in-force, version_date) instead of raw XML.
legislation_get_toc
Retrieve the table of contents for a UK Act or SI.
Returns structural elements (parts, chapters, sections, schedules) with XML id
and title, e.g. 'section-47: Definitions'. When calling legislation_get_section,
pass only the numeric part — use '47', not 'section-47'.
Large statutes (Companies Act 2006 has 1300+ items) are paginated
via offset/limit. Check has_more and total_items on the response.
Alternative: read the resource template
`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 `LegislationTOC` response with
offset/limit/has_more for stepping through Companies-Act-scale lists.
parliament_search_hansard
Search Hansard for parliamentary debates, questions, and speeches.
Returns contributions from MPs and Lords including date, party, debate title,
and text (capped at 3000 chars per contribution). Useful for understanding
legislative intent or political context.
parliament_vibe_check
Assess the likely parliamentary reception of a policy proposal.
Searches Hansard for relevant debate contributions, then uses LLM sampling
to classify sentiment and extract supporters, opponents, and key concerns.
Degrades gracefully if sampling is unavailable — returns contributions only.
parliament_find_member
Search for a current or former MP or Lord by name.
Returns all members matching the name query, each with the integer
`id` required by parliament_member_debates and parliament_member_interests,
plus party, constituency, house, and current-sitting status.
parliament_member_debates
Retrieve Hansard contributions by a specific member, optionally filtered by topic.
Use parliament_find_member first to obtain the integer member ID. Each
contribution's text field is capped at 3000 characters.
parliament_member_interests
Look up registered financial interests for a member of Parliament.
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.
Use parliament_find_member first to obtain the integer member_id.
parliament_search_petitions
Search UK Parliament petitions by keyword.
Returns petition title, state, signature count, and dates for government response
or parliamentary debate if applicable.
bills_search_bills
Search UK parliamentary bills by keyword, session, house, or legislative stage.
Returns a paginated page of bill summaries including title, current stage, and
whether it has become an Act. Use bills_get_bill with the bill ID for full detail.
bills_get_bill
Get full detail for a specific parliamentary bill.
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 to see if it was cut.
votes_search_divisions
Search parliamentary divisions (votes) in the Commons or Lords.
Returns division summaries including title, date, vote counts, and whether the motion passed.
Use votes_get_division with the division ID for full voter lists.
votes_get_division
Get full detail for a parliamentary division including how each member voted.
Voter lists are truncated to 100 per side to fit response limits.
Total voter counts are always accurate regardless of truncation.
committees_search_committees
Search or list UK parliamentary select committees.
Returns committee names, house, and active status.
Use committees_get_committee with the committee ID for membership detail.
committees_get_committee
Get detail for a parliamentary committee including current membership.
Fetches committee metadata and member list in parallel.
committees_search_evidence
Search oral and written evidence submitted to a parliamentary committee.
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.
citations_parse
Extract and classify all OSCOLA legal citations from free text.
Identifies: neutral citations ([2024] UKSC 12), law reports ([2024] 1 WLR 100),
legislation sections (s.47 Companies Act 2006), SIs (SI 2018/1234),
and retained EU law (Regulation (EU) 2016/679).
Ambiguous citations (e.g. bare [2024] EWHC without division) are optionally
disambiguated via LLM sampling. Resolves citations to TNA / legislation.gov.uk URLs.
citations_resolve
Parse and resolve a single OSCOLA citation to its canonical URL.
Supports: neutral citations, SIs, legislation sections, retained EU law.
Returns parsed fields and resolved_url if resolvable. Raises ValueError
if no recognised citation is found in the input.
citations_network
Map all citations within a judgment — cases cited, legislation referenced, SIs, EU law.
Fetches the judgment XML from TNA and parses all OSCOLA citations within it.
Returns citations grouped by type for easy analysis. Each bucket is
de-duplicated and sorted.
hmrc_get_vat_rate
Look up the UK VAT rate for a commodity or service type.
Returns the rate category (standard 20%, reduced 5%, zero 0%, exempt),
effective date, and any relevant conditions or exceptions.
Uses a static lookup table current as of 22 Nov 2023 (Autumn Statement).
Rates may have changed — always verify against GOV.UK for recent Budgets.
hmrc_check_mtd_status
Check a business's Making Tax Digital VAT mandate status via the HMRC API.
NOTE: Connects to the HMRC sandbox by default. Set HMRC_API_BASE env var to
'https://api.service.hmrc.gov.uk' for production.
Requires HMRC_CLIENT_ID and HMRC_CLIENT_SECRET environment variables (OAuth 2.0).
Returns whether the business is mandated for MTD, effective date, and trading name.
hmrc_search_guidance
Search GOV.UK for HMRC tax guidance documents.
Returns matching guidance titles, URLs, summaries, and last-updated dates.
Searches the official GOV.UK content API filtered to HMRC publications.
list_prompts
List all available prompts.
Returns JSON with prompt metadata including name, description,
and optional arguments.
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.