Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UK Digger

Global UK Government digger — a Claude Code plugin giving a direct line into UK government data and services. One MCP server, one command per sector, answers from live official APIs instead of stale training data.

Unofficial. Not affiliated with or endorsed by the UK Government. Output is official data, not legal, financial, or immigration advice.

Install

/plugin marketplace add soheilfallah/ukdigger
/plugin install ukdigger@soheil-ukdigger

Prerequisite: uv (the server runs via uv run --script; dependencies resolve automatically on first launch).

On install you'll be asked for two optional free keys — leave blank to run with the catalogue + open-data tools only:

Key Get it at Unlocks
Companies House API key developer.company-information.service.gov.uk → create application → REST API key live company register: name availability, officers, filings, PSC
EPC bearer token get-energy-performance-data.communities.gov.uk → GOV.UK One Login → bearer token Energy Performance Certificates

Commands

Command Sector
/ukdigger:dig Any UK gov question — auto-routes
/ukdigger:business Company name availability, register lookups, due diligence
/ukdigger:property EPC certificates, sold prices, flood risk
/ukdigger:immigration Current visa/citizenship rules from GOV.UK
/ukdigger:local-area Postcode intel, crime, food hygiene
/ukdigger:health NHS organisations, GP/pharmacy/hospital lookup
/ukdigger:parliament MPs, votes, debates, bills, written questions
/ukdigger:law Legislation text, courts and tribunals
/ukdigger:transport TfL status, journeys, vehicle checks
/ukdigger:environment Floods, air quality, carbon intensity
/ukdigger:stats ONS releases, labour market, census (NOMIS)

Server tools

  • search_apis / get_api_details / list_providers — the full api.gov.uk catalogue (~230 APIs across 35 departments), auto-downloaded and cached weekly.
  • search_companies / get_company — live Companies House register (keyed).
  • search_epc — live Energy Performance Certificates (keyed).
  • fetch_api — GET any catalogued or curated open UK gov endpoint (https-only, host-allowlisted, redirect-checked; auth auto-attached for hosts you hold keys for).

Open endpoints that work with zero keys include: all GOV.UK content and search, postcodes.io, police crime data, food hygiene ratings, Land Registry Price Paid, Environment Agency flood monitoring, all four Parliament APIs, legislation.gov.uk, NHS ODS, TfL, carbon intensity, ONS and NOMIS.

Local development

git clone https://github.com/soheilfallah/ukdigger
cd ukdigger
cp server/.env.example server/.env   # fill in your keys (optional)
uv run --script server/test_server.py

The smoke test needs network access; keyed sections skip cleanly when no key is configured.

License

MIT

About

Global UK Government digger — Claude Code plugin: live UK gov data via api.gov.uk catalogue, Companies House, EPC, and one command per sector

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages