ONS Trade Data API — MCP Server

An MCP (Model Context Protocol) server that exposes UK trade data from:

• https://ons-trade-data-api.netlify.app

Modeled on your previous ons-baby-names-api-mcp server: Python + FastMCP, deployable to Vercel, with a streamable HTTP MCP endpoint at /mcp.

Tools

Tool	Description
health	Check MCP server and upstream API connectivity
get_schema	Dataset metadata (version, last_updated, total_records)
get_time_periods	List available dates
get_countries	Country code lookup
get_commodities	Commodity metadata lookup
get_country_index	Available commodities and periods for a country
fetch_raw	Direct raw JSON fetch from /data/... path
get_trade_file	Fetch one static trade file with optional filtering
query_trade	Generic grouped aggregation query over a trade file

MCP endpoint

After deployment, connect an MCP client to:

https://ons-trade-data-api-mcp.vercel.app/mcp

Environment variable

Variable	Default	Description
TRADE_API_BASE_URL	https://ons-trade-data-api.netlify.app	Upstream trade API base URL

Deploy to Vercel

1. Push this repo to GitHub
2. Import it in Vercel
3. Deploy (no custom build needed)

Local development

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py

Server runs locally at:

http://localhost:8000/mcp