paulieb89/govuk-mcp
0 Views
0 Installs
🐍 ☁️ - Search GOV.UK content, retrieve full government pages, look up organisations, and resolve UK postcodes to local authorities. 5 read-only tools, no API keys required.
Quick Install
One-Click IDE Configuration
claude_desktop_config.json
{
"mcpServers": {
"paulieb89-govuk-mcp": {
"command": "npx",
"args": [
"-y",
"paulieb89-govuk-mcp"
]
}
}
}Or
Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
govuk-mcp
MCP server for GOV.UK — search, content retrieval, organisation lookup, and postcode resolution.
Tools
| Tool | Description |
|---|---|
govuk_search | Full-text search across 700k+ GOV.UK pages, with format and organisation filters |
govuk_get_content | Page metadata and navigable section index for any GOV.UK page by base path |
govuk_get_section | Body HTML for a single named section (anchor) of a GOV.UK page |
govuk_grep_content | Regex/substring search within the body of a specific GOV.UK page |
govuk_get_organisation | Get details for a UK government organisation (type, parent, children, contacts) |
govuk_list_organisations | Paginated list of all government organisations registered on GOV.UK |
govuk_lookup_postcode | 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.
Resources
For protocol-aware clients (Claude, Cursor, Inspector), the server also exposes govuk:// resource templates:
| URI | Returns |
|---|---|
govuk://content/{base_path*}/header | Page metadata (title, doc type, dates) |
govuk://content/{base_path*}/index | Section anchor:heading list |
govuk://content/{base_path*}/section/{anchor} | Bounded HTML for one section |
govuk://content/{base_path*}/details/{field} | Schema-specific details field |
govuk://content/{base_path*}/links/{rel} | Related content by link type |
govuk://organisation/{slug} | Organisation profile |
Connect
Hosted (no install)
{
"mcpServers": {
"govuk": {
"type": "http",
"url": "https://govuk-mcp.fly.dev/mcp"
}
}
}
Local (uvx)
{
"mcpServers": {
"govuk": {
"type": "stdio",
"command": "uvx",
"args": ["govuk-mcp"]
}
}
}
APIs used
| API | Base URL | Auth |
|---|---|---|
| GOV.UK Search | https://www.gov.uk/api/search.json | None |
| GOV.UK Content | https://www.gov.uk/api/content{path} | None |
| GOV.UK Organisations | https://www.gov.uk/api/organisations | None |
| postcodes.io | https://api.postcodes.io | None |
License
MIT