How to Use the UK ONS Full — Complete Statistical Intelligence MCP in OpenAI Agents SDK

Q: How do I find all available data types with UK ONS Full — Complete Statistical Intelligence and OpenAI Agents SDK?

Start by using listdatasets. It gives you an overview of the 337+ datasets, covering everything from population to trade. This helps your agent scope out exactly what's possible before querying.

Q: Can I query trade metrics with UK ONS Full — Complete Statistical Intelligence and OpenAI Agents SDK?

Absolutely. The gettrade tool provides monthly data on UK goods trade—imports, exports, and the balance—broken down by commodity and partner country.

Q: How do I ensure my agent correctly filters ONS datasets with UK ONS Full — Complete Statistical Intelligence and OpenAI Agents SDK?

The getdimensions tool is key here. It lets you check every available dimension and filter option for a specific dataset, so your agent knows exactly what query parameters to use.

Build production AI agents with UK ONS Full — Complete Statistical Intelligence and OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect UK ONS Full — Complete Statistical Intelligence MCP to OpenAI Agents SDK

Create your Vinkius account to connect UK ONS Full — Complete Statistical Intelligence to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup UK ONS Full — Complete Statistical Intelligence with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Querying economic trends.

Use the `get_gdp` tool to pull both quarterly and annual UK GDP data. You can filter results by region or sector, making sure your agent captures full time series data using `time=*`. Need a broader look? The `get_economy_dataset` tool handles common IDs like `cpih01` and `retail-sales-index`, letting you query any major ONS dataset with flexible filters.

Analyzing consumer spending.

The `get_spending_cards` tool provides near real-time insight into consumer habits using weekly debit and credit card data. This gives your agent a better pulse than static reports. Furthermore, running `get_retail_sales` gets you the value and volume of Great Britain's retail sales index monthly. Combine this with card spending to give users a complete picture.

Building specialized reporting.

The `get_business_counts` tool retrieves UK business counts by local units, enterprises, and industry from the IDBR. This is perfect for scoping out regional market sizes. Want to understand household finance? Check out `get_tax_benefits`. It shows how taxes and benefits affect overall UK household income.

Setup guide

Set up UK ONS Full — Complete Statistical Intelligence MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all UK ONS Full — Complete Statistical Intelligence tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives UK ONS Full — Complete Statistical Intelligence tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate UK ONS Full — Complete Statistical Intelligence tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="UK ONS Full — Complete Statistical Intelligence Agent",
            instructions="You have access to UK ONS Full — Complete Statistical Intelligence tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by UK ONS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect UK ONS Full — Complete Statistical Intelligence now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about UK ONS Full — Complete Statistical Intelligence MCP in OpenAI Agents SDK

Start by using `list_datasets`. It gives you an overview of the 337+ datasets, covering everything from population to trade. This helps your agent scope out exactly what's possible before querying.

The server offers multiple views on personal well-being. You can use `get_wellbeing` for quarterly national estimates, or `get_wellbeing_local` to drill down into local authority data.

Absolutely. The `get_trade` tool provides monthly data on UK goods trade—imports, exports, and the balance—broken down by commodity and partner country.

The `get_dimensions` tool is key here. It lets you check every available dimension and filter option for a specific dataset, so your agent knows exactly what query parameters to use.

This server touches statistical demographic data, including local authority population projections and suicide registrations. Always ensure agents handle this sensitive information within strict guardrails.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript