paulieb89/govuk-mcp

PyPI Glama smithery badge Install in VS Code Install in VS Code Insiders Install in Cursor Install in VS Code (local)

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