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

Metadata

Release files for govuk-mcp 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for govuk-mcp 0.3.0
File	Size	Uploaded	Provenance
govuk_mcp-0.3.0.tar.gz	151.5 kB	May 7, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for govuk-mcp 0.3.0
File	Interpreter	ABI	Platform	Reset
govuk_mcp-0.3.0-py3-none-any.whl 18.1 kB May 7, 2026 With provenance	Python 3	none	any	Details

Total release size: 169.6 kB

Release files / govuk_mcp-0.3.0.tar.gz

Download URL	govuk_mcp-0.3.0.tar.gz
Size	151.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`64f7a6860c29469bed493d53db33b9cc8ce5df156c7ed81fd964a87cfd99cdfa`
BLAKE2b-256 checksum How to use checksums	`aee93f6be0cd0c83db2a72a749b85ed1f05c4a2e10b126d2b9ea6131c6d9569d`
Upload date	May 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/paulieb89/govuk-mcp
Publishing commit: github.com/paulieb89/govuk-mcp/tree/f11d27998a3df4345bcd9f8213d1705ee06e928c

Workflow

Publishing configuration: github.com/paulieb89/govuk-mcp/blob/f11d27998a3df4345bcd9f8213d1705ee06e928c/.github/workflows/release.yml
Publishing logs: github.com/paulieb89/govuk-mcp/actions/runs/25506090726/attempts/1

Artifact

Subject: govuk_mcp-0.3.0.tar.gz
SHA-256 checksum: 64f7a6860c29469bed493d53db33b9cc8ce5df156c7ed81fd964a87cfd99cdfa Verifying attestations

Release files / govuk_mcp-0.3.0-py3-none-any.whl

Download URL	govuk_mcp-0.3.0-py3-none-any.whl
Size	18.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`dd2a93ed348da0dcd0e5c608361b1c0c40fef8497a9a44a89657013caca80c7e`
BLAKE2b-256 checksum How to use checksums	`1ffd6b7426e09bd762c0a66f17646b15fe835c0aeb32136dd9d3f0d319639666`
Upload date	May 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/paulieb89/govuk-mcp
Publishing commit: github.com/paulieb89/govuk-mcp/tree/f11d27998a3df4345bcd9f8213d1705ee06e928c

Workflow

Publishing configuration: github.com/paulieb89/govuk-mcp/blob/f11d27998a3df4345bcd9f8213d1705ee06e928c/.github/workflows/release.yml
Publishing logs: github.com/paulieb89/govuk-mcp/actions/runs/25506090726/attempts/1

Artifact

Subject: govuk_mcp-0.3.0-py3-none-any.whl
SHA-256 checksum: dd2a93ed348da0dcd0e5c608361b1c0c40fef8497a9a44a89657013caca80c7e Verifying attestations

Security for govuk-mcp 0.3.0

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for govuk_mcp-0.3.0.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/paulieb89/govuk-mcp
Publishing commit: github.com/paulieb89/govuk-mcp/tree/f11d27998a3df4345bcd9f8213d1705ee06e928c

Workflow

Publishing configuration: github.com/paulieb89/govuk-mcp/blob/f11d27998a3df4345bcd9f8213d1705ee06e928c/.github/workflows/release.yml
Publishing logs: github.com/paulieb89/govuk-mcp/actions/runs/25506090726/attempts/1

Artifact

Subject: govuk_mcp-0.3.0.tar.gz
SHA-256 checksum: 64f7a6860c29469bed493d53db33b9cc8ce5df156c7ed81fd964a87cfd99cdfa Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.