GOV UK Search
GOV.UK Search MCP server: search and read GOV.UK content, explore government organisations, and resolve UK postcodes — no API keys needed.
Full-text search across 700k+ GOV.UK pages (
govuk_search), with filters for document format (guide, transaction, publication, news article, etc.), organisation slug, result count (1–50), pagination offset, and sort order (e.g. newest-first).Page retrieval (
govuk_get_content): metadata (title, document type, dates) plus a navigable index of section anchors and headings for any page by base path.Section reading (
govuk_get_section): fetch the body HTML of one specific section by its anchor ID.In-page pattern search (
govuk_grep_content): regex or literal substring search within a page's body, returning anchor, heading, and ~200-char snippets per hit, with case-insensitivity and hit limits.Organisation lookup (
govuk_get_organisation): profile by slug — title, acronym, type, status, web URL, contacts, parent and child organisations.Organisation browsing (
govuk_list_organisations): paginated listing of all GOV.UK-registered bodies to discover slugs for filters or lookups.Postcode resolution (
govuk_lookup_postcode): map a UK postcode to local authority, region, country, constituency (current and 2025 boundaries), NHS integrated care board, coordinates, and GSS codes.Resource templates for protocol-aware clients:
govuk://content/{base_path}/header,/index,/section/{anchor},/details/{field},/links/{rel}, andgovuk://organisation/{slug}.Chained workflows: search results return
next_stepsURIs so you can go from a search hit to headers, section index, and specific sections; organisations can be filtered into searches.Access: hosted HTTP endpoint (Claude connectors, Claude Code, VS Code, Cursor) with read-only, non-destructive, idempotent operations. Local stdio mode is not yet supported.
govuk-mcp
Maintained by BOUCH — private hosting, custom tools and setup: paul@bouch.dev · bouch.dev/products/govuk-mcp
MCP server for GOV.UK — search, content retrieval, organisation lookup, and postcode resolution.
Tools
Tool | Description |
| Full-text search across 700k+ GOV.UK pages, with format and organisation filters |
| Page metadata and navigable section index for any GOV.UK page by base path |
| Body HTML for a single named section (anchor) of a GOV.UK page |
| Regex/substring search within the body of a specific GOV.UK page |
| Get details for a UK government organisation (type, parent, children, contacts) |
| Paginated list of all government organisations registered on GOV.UK |
| Resolve a UK postcode to local authority, region, constituency, and NHS board |
All data is sourced from official public GOV.UK APIs and postcodes.io. No API keys required.
Related MCP server: @mountainpass/addressr-mcp
Resources
For protocol-aware clients (Claude, Cursor, Inspector), the server also exposes govuk:// resource templates:
URI | Returns |
| Page metadata (title, doc type, dates) |
| Section anchor:heading list |
| Bounded HTML for one section |
| Schema-specific details field |
| Related content by link type |
| Organisation profile |
Connect
Hosted endpoint — no install, no API key:
https://govuk-mcp.fly.dev/mcpClaude (web, desktop and mobile)
Open Customize → Connectors (claude.ai/customize/connectors).
Click Add custom connector.
Name it
govuk, paste the URL above and click Add. No sign-in is needed.
That's it — no config file to edit and no restart. Add the connector on web or desktop, and it's then available on your account, including the mobile apps. Turn it on or off per chat from the + menu → Connectors. On Team and Enterprise plans an Owner adds it once under Organization settings → Connectors; Free plans can add one custom connector.
Claude Code
If you've added the connector above, Claude Code lists it under /mcp — but only when Claude Code is signed in with your claude.ai subscription login, not an API key. Otherwise, add it directly:
claude mcp add --transport http --scope user govuk https://govuk-mcp.fly.dev/mcpOther clients
VS Code and Cursor: use the install badges at the top of this page. For clients configured with mcpServers JSON:
{
"mcpServers": {
"govuk": {
"type": "http",
"url": "https://govuk-mcp.fly.dev/mcp"
}
}
}Run it locally (stdio)
Local stdio mode isn't supported yet (#8); use the hosted endpoint.
APIs used
API | Base URL | Auth |
GOV.UK Search |
| None |
GOV.UK Content |
| None |
GOV.UK Organisations |
| None |
postcodes.io |
| None |
License
MIT
Available Tools
7 toolsgovuk_get_contentGet GOV.UK PageARead-onlyIdempotent
Get metadata and navigable section index for a GOV.UK page.
Returns the page title, document type, publication dates, and a list of sections with their anchor IDs and headings. Use govuk_get_section to read the body of a specific section, or govuk_grep_content to search within the page body.
Inputs: base_path (required). Returns: object
govuk_get_organisationGet GOV.UK OrganisationARead-onlyIdempotent
Get the profile of a UK government organisation by its slug.
Returns name, acronym, type, status, web URL, and parent/child organisations. Use govuk_list_organisations to browse all organisations and discover slugs.
Inputs: slug (required). Returns: A UK government organisation record.
govuk_get_sectionGet GOV.UK Page SectionARead-onlyIdempotent
Get the HTML content of one named section of a GOV.UK page.
Use govuk_get_content first to get the list of available section anchors, then call this with the anchor of the section you want to read.
Inputs: anchor (required), base_path (required). Returns: object
govuk_grep_contentSearch within a GOV.UK content bodyARead-onlyIdempotent
Find body sections in a GOV.UK content item matching a pattern.
Returns a list of {anchor, heading, snippet, match} hits — small per-section
snippets centred on the match — so the LLM can decide which full sections to
read via govuk_get_section.
Use this when answering content-based questions ("what does this guide say about X?", "find the bit about eligibility") rather than navigating by section number.
Pattern is regex; if it doesn't compile, falls back to literal substring.
Inputs: pattern (required), base_path (required), max_hits, case_insensitive. Returns: Output schema for govuk_grep_content.
govuk_list_organisationsList GOV.UK OrganisationsARead-onlyIdempotent
List all UK government organisations registered on GOV.UK.
Returns a paginated list of organisations including their slug, acronym, type, and status. Use this to browse the full government structure or discover slugs for use with govuk_get_organisation or govuk_search filters.
Inputs: page, per_page. Returns: A page of UK government organisations.
govuk_lookup_postcodeLook Up UK PostcodeARead-onlyIdempotent
Look up a UK postcode to retrieve its local authority, region, constituency, and other administrative geography.
Useful for determining which council area, parliamentary constituency, or NHS region a postcode falls within. Commonly used to direct users to the correct local service on GOV.UK (e.g. council tax, planning, waste).
Uses the postcodes.io public API (no key required).
Inputs: postcode (required). Returns: UK postcode lookup result with administrative geography.
govuk_searchSearch GOV.UKARead-onlyIdempotent
Search GOV.UK's 700k+ content items using the official Search API.
Returns a list of matching content items with title, description, link, format, owning organisation(s), and last updated timestamp.
Use filter_format to narrow to specific content types (e.g. 'transaction' for citizen-facing services, 'guide' for guidance, 'publication' for official documents). Use filter_organisations to restrict to a department.
Inputs: query (required), count, order, start, +2 more. Returns: A page of GOV.UK search results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clear, distinct purpose with no overlap. Tools like govuk_get_content, govuk_get_section, and govuk_grep_content are designed to work together in a chained manner, avoiding ambiguity.
All tools follow a consistent 'govuk_verb_noun' pattern (e.g., govuk_get_content, govuk_list_organisations, govuk_lookup_postcode), making the naming predictable and easy to understand.
Seven tools is an appropriate number for the server's purpose—searching and retrieving UK government information. Each tool earns its place by providing essential functionality without redundancy.
The tool set covers the core use cases: content search and retrieval, section navigation, organisation lookup, and postcode-based geographic information. No obvious gaps for a read-only government information server.
Maintenance
Related MCP Connectors
data.gov.uk MCP — UK national open-data portal (CKAN API).
MCP server for the GovContractScout US government contracts API: search, NAICS, match scoring.
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP server for searching npm packages1227 npm16MIT
- AlicenseNot gradedqualityFmaintenanceMCP server for Australian address search and validation powered by Addressr.Apache 2.0
- AlicenseCqualityCmaintenanceMCP server for the UK Bus Open Data Service, enabling timetable queries, stop search, route discovery, journey planning, and real-time bus tracking.1623 PyPIMIT
- AlicenseAqualityBmaintenanceMCP server for live web search and clean-markdown page fetch over the Keenable web index.2138 npm8MIT