# postcodecontext.uk

> postcodecontext.uk is a paid MCP server for maps and travel. Pay-per-call UK postcode data: census, house prices, EPC, deprivation, schools and rail. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://api.postcodecontext.uk
- **Repository:** https://github.com/postcodecontext/postcode-context-mcp
- **MCP Registry name:** uk.postcodecontext/mcp
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-21

## About

This server turns a Great Britain postcode into a structured profile, and it is built for agents that pay per request. Coverage is 1,760,216 postcodes in England, Scotland and Wales; Northern Ireland and the Crown Dependencies are left out because of separate licensing.

The data blends ONS Census 2021 and NRS Scotland Census 2022 demographics, deprivation deciles (IoD 2025, WIMD 2025, SIMD 2020v2), HM Land Registry and Registers of Scotland residential prices, EPC ratings and Ofcom gigabit broadband availability. The README also mentions schools, GP healthcare and rail transit. Most data is under the Open Government Licence v3.0, with attribution notices.

Paid calls cost $0.005 for a postcode or outcode, $0.010 to compare 2 to 5 postcodes, and $0.050 to batch up to 50, settled in USDC on Base through x402 v2. Discovery calls, `tools/list`, the data dictionary and attribution are free. There is no free sandbox for the intelligence routes. The README counts eight paid MCP tools.

## Features

- **Postcode profile:** One call returns demographic, property, energy, school and broadband context.
- **Compare postcodes:** Rank 2 to 5 postcodes side by side.
- **Batch enrichment:** Enrich up to 50 postcodes in one request.
- **Outcode summaries:** Aggregate a postal district such as SW1A.
- **Free reference tools:** get_data_dictionary and get_data_attribution need no payment.
- **x402 payments:** Per-call USDC settlement on Base with sponsored gas.

## Good for

- Compare two neighbourhoods before a property search
- Enrich a customer list with area deprivation deciles
- Check gigabit availability for a set of addresses
- Add sourced context to a location-aware agent answer
- Look up energy ratings by postcode

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.postcodecontext.uk/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.postcodecontext.uk/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.postcodecontext.uk/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.postcodecontext.uk/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.postcodecontext.uk/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.postcodecontext.uk/mcp
```

Enter a Name (for example "postcodecontext.uk"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.postcodecontext.uk/mcp"
    }
  }
}
```

## Tools

All 10 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `lookup_postcode` (says read-only): Use when you need demographic, property, EPC energy efficiency, broadband, or socio-economic context for a Great Britain unit postcode (England, Scotland, Wales). Returns full profile by default; use view="brief" (~80 tokens) for low-token, concise briefings when managing context budget. Do not use for non-GB postcodes (e.g. Northern Ireland BT) or when comparing multiple postcodes simultaneously 
- `compare_postcodes` (says read-only): Use when you need to directly contrast 2 to 5 Great Britain postcodes across affluence, safety, housing cost per m², broadband, and family suitability. Returns full profiles by default; use view="brief" (~80 tokens per postcode) to keep context compact alongside the comparison ranking. Do not use for single postcode inspection (use lookup_postcode) or bulk batches of >5 postcodes (use enrich_postc
- `enrich_postcodes` (says read-only): Bulk demographic, economic, and spatial lookup for 1 to 50 Great Britain postcodes. Returns brief profile by default (~80 tokens per postcode) to prevent context blow-up; use view="full" when all 113 metrics are needed. Cost-effective for 6 to 50 postcodes ($0.050 flat fee). For 1 postcode use lookup_postcode ($0.005); for 2 to 5 postcodes use compare_postcodes ($0.010). Do not use when detailed s
- `summarise_outcode` (says read-only): Use when you only have an outward code / district (e.g. SW1A, BB7, EH1, CF10) and need high-level district demographic and property statistics (~150 tokens). Do not use when an exact full unit postcode is available (use lookup_postcode).
- `get_postcode_ai_brief` (says read-only): Retrieve an ultra-lightweight, token-efficient natural language briefing, affluence tier, and persona profile (~80 tokens) for fast autonomous agent decision-making across Great Britain. Covers England, Scotland, and Wales (excludes Northern Ireland BT postcodes).
- `get_property_and_energy_profile` (says read-only): Retrieve real estate valuation (HM Land Registry / Registers of Scotland median house price, price per sqm, 3yr sales volume), EPC energy efficiency (current/potential band, retrofit upside), and Ofcom gigabit broadband connectivity for any Great Britain postcode. Covers England, Scotland, and Wales (excludes Northern Ireland BT postcodes).
- `get_demographics_and_deprivation` (says read-only): Retrieve Census demographic breakdown (ONS Census 2021 / NRS Scotland Census 2022 income estimate, qualifications, tenure, employment, age) and statutory IMD deprivation deciles (IoD 2025, WIMD 2025, SIMD 2020 crime safety, education, living environment) for any Great Britain postcode. Covers England, Scotland, and Wales.
- `screen_postcodes` (says read-only): Rank and screen 2 to 10 Great Britain postcodes by a specific target metric (affluence, house price, crime safety, broadband speed, family suitability, or connectivity). Returns a sorted leaderboard. For 11 to 50 postcodes use enrich_postcodes; for full cross-metric comparison of 2 to 5 postcodes use compare_postcodes.
- `get_data_dictionary` (says read-only): $0.00 USDC reference tool (no payment or authentication required; subject to Terms of Service): Retrieve exact field specifications, mathematical calculation formulas, statistical scales, and data sources for any metric across Great Britain in the Postcode Context database.
- `get_data_attribution` (says read-only): $0.00 USDC reference tool (no payment or authentication required; subject to Terms of Service): Retrieve official statutory attribution statements, Crown copyright notices, Royal Mail Gridlink sublicence details, and Open Government Licence v3.0 metadata across all 19 contributing data providers (ONS, OS, Royal Mail, HM Land Registry, Registers of Scotland, MHCLG, Ofcom, Scottish Government, Welsh

## FAQ

### How much does a call cost?

$0.005 for a postcode or outcode, $0.010 to compare, $0.050 for a batch of up to 50.

### Is there a free tier?

Not for intelligence routes; only discovery, the data dictionary and attribution are free.

### Does postcodecontext.uk cover Northern Ireland?

No. BT postcodes and the Crown Dependencies are excluded.

### How do I pay?

In USDC on Base Mainnet through the x402 v2 protocol.

### How do I add postcodecontext.uk to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.postcodecontext.uk/mcp

### What are the best alternatives to postcodecontext.uk?

The closest alternatives to postcodecontext.uk are UK Postcode Intel, Uk Postcodes Mcp, L50 UK Property Data, fourzerotwo and XRPLME Country Intelligence.

## Where this comes from

- Description: written from the project's README and the project's website.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [UK Postcode Intel](https://ai-powered.com/mcp/uk-postcode-intel): UK Postcode Intel is a paid MCP server for maps and travel.
- [Uk Postcodes Mcp](https://ai-powered.com/mcp/uk-postcodes-mcp): Uk Postcodes Mcp is a freemium MCP server for maps and travel.
- [L50 UK Property Data](https://ai-powered.com/mcp/l50-uk-property-data): L50 UK Property Data is a paid MCP server for analytics and data.
- [fourzerotwo](https://ai-powered.com/mcp/fourzerotwo): fourzerotwo is a freemium MCP server for analytics and data.
- [XRPLME Country Intelligence](https://ai-powered.com/mcp/xrplme-country-intelligence): XRPLME Country Intelligence is a paid MCP server for analytics and data.
- [Oga MCP](https://ai-powered.com/mcp/oga-mcp): Oga MCP is a freemium MCP server for analytics and data.
- [Lilambd Data for Agents](https://ai-powered.com/mcp/lilambd-data-for-agents): Lilambd Data for Agents is a paid MCP server for analytics and data.
- [HMS x402 Data Origins (RE Data Refinery + Storefront)](https://ai-powered.com/mcp/hms-x402-data-origins-re-data-refinery-storefront): HMS x402 Data Origins (RE Data Refinery + Storefront) is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/postcodecontext-uk
