# UK ONS Full MCP for AI Agents AI Agent Connect

> UK ONS Full provides direct access to the UK Office for National Statistics database. It gives your AI agent 20 tools to pull real-time and historical data on GDP, inflation, retail sales, and population trends. You can query over 330 datasets without needing an API key. It is the fastest way to ground your analysis in official government statistics.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_elId3ORHnly5hmv8I2ZP1QwKuXGH3LHeJ39nOp7z/ai-agent-connect
- **Tags:** statistics, economic-data, population-data, trade-statistics, data-query, public-records

## Description

Stop jumping between government websites and copy-pasting tables into your spreadsheets. This Connector lets you ask your AI client for specific UK economic figures and get the raw data back instantly. You can pull regional GDP figures, check the latest inflation rates, or look up retail sales volumes without ever leaving your workspace. It handles the heavy lifting of navigating the ONS catalog, letting you focus on what the numbers actually mean for your project. Because Vinkius makes it so easy to connect these tools, you can turn your agent into a high-level research analyst that knows the UK's economic landscape inside out. Whether you are looking for small business counts in a specific county or tracking national trade balances, the data is just a prompt away. You get the official numbers used by policymakers and economists, delivered directly to your chat window.

## Tools

### search_datasets
Find specific dataset IDs and descriptions from the 337+ available ONS records.

### list_datasets
Browse the entire ONS catalog to see what data is available for your project.

### get_dataset_info
Pull metadata like dimensions and versions for a specific ONS dataset.

### get_dimensions
See the available filters and categories for a dataset to help refine your query.

### get_dimension_options
Get the specific values for a dimension like geography codes or time periods.

### get_observations
Query specific data points from any ONS dataset using your chosen filters.

### get_gdp
Pull quarterly and annual GDP data for England, Wales, and various regions.

### get_cpih
Get the official UK inflation measure including housing costs.

### get_retail_sales
Pull monthly value and volume data for consumer spending in Great Britain.

### get_spending_cards
Get weekly insights into debit and credit card spending patterns.

### get_tax_benefits
See how taxes and benefits impact household income across the UK.

### get_economy_dataset
Query any of the primary economy datasets using specific IDs and filters.

### get_weekly_deaths
Get weekly registration numbers for deaths by age, sex, and region.

### get_wellbeing
Pull national estimates on life satisfaction, happiness, and anxiety levels.

### get_wellbeing_local
Get well-being stats broken down by specific UK local authorities.

### get_suicides
Pull national suicide registration data by local authority in England and Wales.

### get_population_projections
Get projections for older people and sex ratios by local authority.

### get_trade
Pull monthly data on UK imports, exports, and trade balances by country.

### get_business_counts
Get counts of UK enterprises and local units by industry and location.

### get_traffic_activity
Get experimental traffic camera data as an indicator of economic activity.

## Prompt Examples

**Prompt:** 
```
What's the current inflation rate in the UK?
```

**Response:** 
```
The headline UK inflation measure (CPIH) was 3.2% in February 2026. This includes housing costs and reflects the current consumer price index.
```

**Prompt:** 
```
Compare retail sales for Great Britain over the last 3 months.
```

**Response:** 
```
Here is the monthly retail sales index for Great Britain (Base 2019=100): 

| Month | Value Index | Volume Index |
|---|---|---|
| Jan 2026 | 104.2 | 103.8 |
| Feb 2026 | 104.5 | 104.1 |
| Mar 2026 | 105.1 | 104.9 |
```

**Prompt:** 
```
Give me a summary of UK trade with the EU.
```

**Response:** 
```
The UK's trade in goods with the EU shows a trade balance of -£8.6B. This includes both imports and exports across various commodities.
```

## Capabilities

### Pull regional GDP data
Get quarterly and annual GDP figures for England, Wales, and various regions.

### Check official inflation rates
Retrieve the headline CPIH measure including housing costs.

### Get retail sales volumes
Access monthly value and volume data for consumer spending in Great Britain.

### Track card spending patterns
Get weekly insights into debit and credit card spending trends.

### Look up population projections
Fetch projections for older people and sex ratios by local authority.

### Query specific ONS datasets
Search and query over 330 available datasets using specific filters.

## Use Cases

### Comparative Regional Analysis
A consultant needs to compare regional GDP growth against local inflation for a client presentation. They ask the agent to pull both figures for specific counties.

### Retail Trend Forecasting
A retail analyst wants to see the correlation between card spending and monthly retail sales volumes. They use the agent to fetch the last six months of data.

### Demographic Planning
A local government worker needs to find population projections for an aging demographic in a specific area to plan new services.

### Trade Balance Research
A trade researcher needs to pull the latest import and export balances for a specific country to identify new market opportunities.

## Benefits

- Skip the manual search for ONS data by using search_datasets to find the right records instantly.
- Get accurate inflation and GDP figures for your reports using get_cpih and get_gdp.
- Monitor real-time consumer trends with get_spending_cards and get_retail_sales.
- Analyze local demographics and well-being with get_wellbeing_local and get_population_projections.
- Pull trade and business data for market research using get_trade and get_business_counts.
- Save hours of data entry by letting your agent fetch data directly via get_observations.

## How It Works

The bottom line is you get official UK government statistics without the manual research.

1. Connect the Connector to your AI client via the Vinkius dashboard.
2. Ask your agent a specific question about UK economics or demographics.
3. Get a structured summary of the data with direct links to the source.

## Frequently Asked Questions

**Does the UK ONS Full MCP require a paid account?**
No, it works without an API key. You can connect it to your AI client and start pulling data immediately.

**Can I get regional data for specific UK counties?**
Yes, you can pull GDP and well-being stats for specific regions and local authorities using the built-in dimension filters.

**What kind of economic indicators are included?**
It covers a wide range of indicators including GDP, inflation, retail sales, card spending, and tax benefits.

**Is the population data updated in real time?**
It includes both current estimates and future projections for older people and sex ratios, updated as per the latest ONS releases.

**Can I use this for trade analysis?**
Yes, it includes monthly data on imports, exports, and trade balances by partner country and commodity.

**How do I find a specific dataset?**
Just ask your agent to search the catalog for keywords like 'business', 'health', or 'trade' to find the right records.

**Is the ONS API stable?**
The ONS API is currently in Beta. While fully functional and regularly updated, there may occasionally be breaking changes. Rate limits: 120 requests per 10 seconds, 200 per minute.

**What datasets does this server pull from?**
It has access to the full ONS library of over 337 statistical datasets, spanning GDP, CPIH, retail sales, demographic projections, health indicators, trade, and more.

**Are the GDP and Inflation figures real-time?**
The statistics provided are based on the latest officially published reports from the ONS, which usually trail by a month or a quarter depending on the metric.