uk-ons-mcp-server by dwain-barnes - MCP Server

UK ONS MCP Server

A Model Context Protocol (MCP) server for accessing the UK Office for National Statistics (ONS) Beta API.
Fetch official UK government statistics—demographics, economics, social data—straight from your MCP‑compatible assistant, no API key required.

Features

Direct ONS access – no authentication, no tokens
Browse & search every published dataset
Flexible queries – filter observations by geography, time, etc.
Popular dataset shortcuts for CPIH, regional GDP, wellbeing & more
Time‑series & regional comparisons built in
100 % MCP‑SDK TypeScript with robust error handling

Installation

# Global install
npm install -g uk_ons_mcp_server

# Or one‑off run
npx uk_ons_mcp_server

Usage (Claude Desktop)

{
  "mcpServers": {
    "uk-ons": {
      "command": "npx",
      "args": ["-y", "uk_ons_mcp_server"]
    }
  }
}

Available Tools

Tool	Purpose
`list_datasets`	Paginated list of all datasets
`get_dataset`	Metadata for a single dataset
`search_datasets`	Search by keyword
`get_observation`	Pull observations with dimension filters
`get_latest_data`	Convenience wrapper for the newest figures

Popular Dataset IDs

ID	What it is
`cpih01`	CPIH (UK inflation)
`regional-gdp-by-year`	Regional GDP
`wellbeing-local-authority`	Personal wellbeing
`trade`	UK trade stats
`weekly-deaths-region`	Weekly deaths

Development

git clone https://github.com/dwain-barnes/uk_ons_mcp_server.git
cd uk_ons_mcp_server
npm install
npm run build   # compile TypeScript
npm start       # production
npm run dev     # watch & reload

Tests and linting:

npm test
npm run lint

Contributing

Fork → branch → commit
git push and open a PR
Kindly follow the coding style in src/

License

MIT – see LICENSE.

Disclaimer
This project is unofficial and not endorsed by the UK Office for National Statistics. Data usage remains subject to ONS terms.

dwain-barnes/uk-ons-mcp-server

list_datasets

get_dataset

search_datasets

get_observation

get_latest_data