ukds-mcp
MCP server for the UK Data Service: search the catalogue, manage projects and download microdata.
Configuration
Catalogue search needs no setup. The server reads the catalogue's public GraphQL key from the UKDS catalogue website's own config, the same way the site's browser client gets it, and reads it again if UKDS rotates it. To pin a key instead, set UKDS_GRAPHQL_API_KEY.
Project and download tools need a UK Data Service login. Run the login tool once; session cookies are saved to ~/.config/ukds-mcp/session.json with owner-only permissions.
Development
uv run pytest # offline tests
UKDS_LIVE_TESTS=1 uv run pytest # also checks discovery against the live site
License
Code in this repository is released under the MIT License. Original text and figures are released under CC BY 4.0 with attribution to PolicyEngine. Third-party data and materials keep their own terms.
1 maintainer
Metadata
1 maintainer
Release files for ukds-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ukds_mcp-0.1.1.tar.gz | 12.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ukds_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.3 kB
Release files / ukds_mcp-0.1.1.tar.gz
| Download URL | ukds_mcp-0.1.1.tar.gz |
|---|---|
| Size | 12.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
53feaf40ff4cf1d97309da3c9cf65c6d067f22a6a6fff530c9f55e462df772b5
|
|
BLAKE2b-256 checksum How to use checksums |
99f87938bf84da7f52febcb911ddf1bb8f5aa461067bce7642aa838cf82ff811
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logRelease files / ukds_mcp-0.1.1-py3-none-any.whl
| Download URL | ukds_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed907d811f3db4e99acb467efcc9e7df373f9728ca262e6e00b52632c55aea4a
|
|
BLAKE2b-256 checksum How to use checksums |
29f018681c10d2060c2525a513b01c83dd07861b16a8b86eb2e9df99757ba387
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency log
