Skip to main content

MCP server for GOV.UK — search, content, organisations and postcode lookup

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

govuk_mcp-0.2.2.tar.gz (151.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

govuk_mcp-0.2.2-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file govuk_mcp-0.2.2.tar.gz.

File metadata

  • Download URL: govuk_mcp-0.2.2.tar.gz
  • Upload date:
  • Size: 151.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for govuk_mcp-0.2.2.tar.gz
Algorithm Hash digest
SHA256 0134b97873214995b166e9d704be4f58eba93b633b5caac5baa882ae60e298d9
MD5 d112e4aec2a2d93ff12b1876184dc3b3
BLAKE2b-256 f0a036146f6f774d48b0644a5ad151567ff85c65fa41047e6f81ba764dc1e18a

See more details on using hashes here.

Provenance

The following attestation bundles were made for govuk_mcp-0.2.2.tar.gz:

Publisher: release.yml on paulieb89/govuk-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file govuk_mcp-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: govuk_mcp-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 17.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for govuk_mcp-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 47a9d3314d6a52728875510ed00929a8e6eea320c0bdf8cbd840b17c4614d957
MD5 dc7cfcf9af3164ce35f73ecb0ee50de9
BLAKE2b-256 49ca19441147024d4ea6b1a55b9eda44c2ae2d1012319b0effa1e02226152f50

See more details on using hashes here.

Provenance

The following attestation bundles were made for govuk_mcp-0.2.2-py3-none-any.whl:

Publisher: release.yml on paulieb89/govuk-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page