# UK ONS Full MCP > UK ONS Full — Complete Statistical Intelligence gives you instant access to the UK's massive repository of official government data. It covers everything from GDP growth and CPIH inflation rates to weekly death counts, local authority well-being scores, and national trade flows. You can query over 300 datasets in one place using flexible filters for time, region, and sector. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** statistics, economic-data, population-data, trade-statistics, data-query, public-records ## Description Need to build a comprehensive economic report but don't want to spend days navigating dozens of government websites? This MCP gives you direct access to the full breadth of UK Office for National Statistics data. Think of it as having 20 specialized analysts—one for every major topic—available in your agent, all without needing an API key. Instead of sifting through pages of PDFs and remembering complex dataset IDs, you tell your AI client what you need—for example, 'Compare regional GDP growth to local authority well-being scores over the last five years.' The MCP handles the mapping. It lets you query economic indicators like CPIH inflation, track consumer spending via debit card data, or pull historical trade figures by commodity. If your current process involves manually downloading spreadsheets and cross-referencing dates from multiple sources, this changes that. You connect to Vinkius, which manages this catalog of critical tools, giving your agent a unified front door to the most reliable UK statistics available. Your focus stays on the insight; we handle the data plumbing. ## Tools ### search_datasets Search the ONS catalog by keyword to find matching dataset IDs, titles, and descriptions. ### list_datasets Browse the complete list of over 300 available datasets covering all areas from economy to health. ### get_dataset_info Retrieve metadata for a specific ONS dataset, showing its dimensions, editions, and versions. ### get_dimensions Get the available filtering options (dimensions) that you can use to narrow down observations within a dataset. ### get_dimension_options List all valid option values for a specific dimension, such as every geography code or time period. ### get_observations Query any ONS dataset using its ID and the filtered dimensions to retrieve actual data points. ### get_gdp Get UK GDP data, including both quarterly and annual figures for regions like England and Wales. ### get_cpih Retrieve the official Consumer Prices Index (CPIH), which measures overall inflation in the UK. ### get_retail_sales Get monthly figures on both the value and volume of retail sales across Great Britain. ### get_spending_cards Access weekly data tracking consumer spending using UK debit and credit cards for a near real-time indicator. ### get_tax_benefits Get statistics showing how taxes and various benefits affect household income in the UK. ### get_economy_dataset Query any core ONS economy dataset using its ID with flexible filters to get comprehensive economic data. ### get_weekly_deaths Retrieve national statistics on death registrations in England and Wales, broken down by age, sex, and region weekly. ### get_wellbeing Get quarterly estimates of personal well-being across the UK, including life satisfaction and happiness scores. ### get_wellbeing_local Retrieve detailed well-being estimates for specific local authorities across the UK. ### get_suicides Get national statistics on suicide registrations by local authority in England and Wales. ### get_population_projections Pull future UK population projections, focusing on older people's sex ratios and local authorities. ### get_trade Get monthly data on UK trade in goods, showing imports and exports by country and commodity. ### get_business_counts Access historical counts of businesses using enterprise and local unit registers, broken down by industry and location. ### get_traffic_activity Get experimental data from traffic cameras used as a real-time indicator of economic activity and social change. ## Prompt Examples **Prompt:** ``` Full UK economic briefing: GDP, inflation, retail, and trade ``` **Response:** ``` 🇬🇧 **UK Economic Briefing** 💰 GDP: +0.3% Q3 2025 (quarterly) 📈 CPIH: 3.2% (February 2026) 🛒 Retail: +1.2% monthly (volume) 🚢 Trade: -£8.6B deficit with EU 💳 Card Spending: +2.1% vs pre-pandemic 5 ONS datasets queried simultaneously. ``` **Prompt:** ``` Can you compare UK GDP growth with the inflation rate (CPIH) over the last year? ``` **Response:** ``` Based on recent ONS data: In the 12 months to February 2026, the CPIH annual inflation rate was 3.2%. Concurrently, UK GDP saw an estimated growth of 0.3% in the latest quarter, indicating low growth against persistent inflation. ``` **Prompt:** ``` Give me a summary of UK population projections and life expectancy. ``` **Response:** ``` According to the latest ONS projections, the UK population is projected to grow to over 70 million by 2036. Period life expectancy at birth in the UK is currently estimated at 79.0 years for males and 82.9 years for females. ``` ## Capabilities ### Track macroeconomic performance Get quarterly and annual figures for GDP, along with inflation rates like CPIH. ### Analyze consumer spending patterns Pull weekly and monthly data on retail sales indices and debit/credit card transaction volumes. ### Model population changes and health risks Retrieve national statistics on life expectancy, well-being scores, and death registrations by region. ### Map global trade flows Query monthly data detailing UK imports and exports of goods by country and commodity. ### Discover available datasets and filters Browse the entire ONS catalog and find specific dimensions, like geography or time periods, needed for your query. ## Use Cases ### Analyzing post-pandemic economic recovery A financial analyst wants to know if increased consumer confidence is reflected in spending. They ask their agent to query `get_spending_cards` (weekly data) and compare the trend against historical retail sales from `get_retail_sales`. The result shows a clear correlation between card use spikes and high volume sales. ### Writing a report on regional inequality A policy researcher needs to assess if wealth disparity is affecting quality of life. They instruct their agent to run `get_wellbeing` (national view) and then cross-reference the results with detailed local authority data from `get_wellbeing_local`, pinpointing specific regions for intervention. ### Modeling demographic pressure on infrastructure A civil engineer needs to estimate future demand. They ask their agent to pull population projections using `get_population_projections` and combine that forecast with the historical business counts from `get_business_counts` to stress-test local service capacity. ### Comparing economic shocks A macroeconomist needs a quick comparison of past crises. They ask their agent to compare GDP figures (`get_gdp`) against the corresponding period's inflation data from `get_cpih`, generating an instant comparative chart showing growth compression. ## Benefits - Compare macro indicators side-by-side. You can run a query linking the CPIH inflation rate to the quarterly GDP using `get_cpih` and `get_gdp`, giving you immediate insight into price vs. growth dynamics. - Move beyond simple charts. Need to understand how policy affects specific groups? Use `get_tax_benefits` alongside `get_wellbeing` data to model potential socioeconomic impacts on households. - Real-time indicators are available for your models. Pair the experimental weekly spending from `get_spending_cards` with current traffic activity from `get_traffic_activity` to gauge immediate market health changes. - It's comprehensive coverage. If you need data—whether it’s trade flows via `get_trade` or business counts via `get_business_counts`—this MCP gives you the correct tool without manual searching. - Understand granular local shifts. You can compare national well-being estimates from `get_wellbeing` against localized reports using `get_wellbeing_local`, helping pinpoint areas needing attention. ## How It Works The bottom line is you don't need deep ONS knowledge; you just tell your agent what question you're asking about UK statistics. 1. First, use `search_datasets` to narrow down the 337+ available datasets by keywords. This tells you which specific data source holds the information you need. 2. Next, if you're unsure how to filter observations, run `get_dimension_options`. This lists all valid filters for that dataset, such as every possible region code or time period. 3. Finally, execute a query using either a dedicated tool (like `get_gdp`) or the general `get_observations` function, providing the ID and the necessary dimension filters to retrieve your specific data points. ## Frequently Asked Questions **How do I find out what type of filters are available using UK ONS Full — Complete Statistical Intelligence?** Use `get_dimension_options`. This tool lists every possible filter value for a specific dataset, whether it's geography (like 'England') or time period. **Can I compare GDP and inflation using UK ONS Full — Complete Statistical Intelligence?** Yes. You can use dedicated tools like `get_gdp` for growth figures and `get_cpih` for the official Consumer Prices Index to run a direct comparison. **What kind of data does get_spending_cards provide?** `get_spending_cards` provides weekly data on UK debit and credit card spending, acting as an experimental indicator of consumer activity in near real-time. **Do I need to know the dataset ID for every query with UK ONS Full — Complete Statistical Intelligence?** Not necessarily. You can start by running `search_datasets` using keywords, which will return matching IDs and descriptions you can then use. **Does this MCP cover historical trade data?** Yes, you can use the `get_trade` tool to access monthly records on UK goods trade, showing both imports and exports broken down by commodity.