Uk MCP

Postcode Context Great Britain — Remote MCP Server & x402 API

Give AI agents real-world UK location intelligence.

Turn any Great Britain postcode (England, Scotland, or Wales) into structured property, demographic, energy, school metadata, GP healthcare, rail transit, and broadband context in one call. Compare locations, batch-enrich up to 50 postcodes per request, and return source-grounded evidence—with transparent per-call pricing from $0.005 per request ($0.050 per 50-postcode batch = $1 per 1,000 postcodes).

Postcode Context Great Britain is a stateless Remote Model Context Protocol (MCP) Server (streamable-http) and REST API delivering socio-economic intelligence, ONS Census 2021 (England & Wales) and NRS Scotland's Census 2022 demographics, Index of Multiple Deprivation (IoD 2025 / WIMD 2025 / SIMD 2020v2) deciles, HM Land Registry & Registers of Scotland residential property prices, MHCLG & Scottish Domestic EPC ratings, and Ofcom gigabit broadband availability across 1,760,216 (1.76M) active Great Britain postcodes.

Northern Ireland (BT) and Crown Dependencies (JE, GY, IM) are excluded due to separate proprietary licensing regimes (e.g., Land & Property Services Northern Ireland). Underlying public sector datasets are predominantly licensed under the Open Government Licence v3.0 (OGL v3.0) alongside Ordnance Survey, ONS, and Royal Mail Gridlink statutory attribution terms; commercial API access and integration usage remain governed by the Terms of Service and License.

---

🌐 Live Server Endpoints & Access Model

Paid Intelligence Endpoints (x402 v2 USDC on Base Mainnet eip155:8453)

Intelligence queries require per-call payment via the x402 v2 protocol (USDC on Base Mainnet with Coinbase CDP sponsored gas). Unpaid requests receive an HTTP 402 Payment Required challenge (REST) or structured x402 payment requirement (MCP). There is no unauthenticated free sandbox tier on REST intelligence routes.

Reference, Schema & Protocol Discovery Endpoints ($0.00 / No Auth — Subject to Terms)

Protocol discovery, schema reference, documentation, and verification routes require no authentication and $0.00 payment. Usage remains subject to the Terms of Service and statutory Crown / OGL v3.0 / Royal Mail attribution notices:

---

📊 Datasets & Coverage Scope

Every full postcode profile joins intelligence across 19 official Great Britain public sector and statutory datasets (applied according to England, Scotland, and Wales jurisdiction via the ONS Postcode Directory ONSPD 2026-Q3, Ordnance Survey OS OpenData, and Royal Mail Gridlink):

1. Property Valuation & Housing Stock (HM Land Registry `2024–2026` & Registers of Scotland `2023–2025`):

• 3-year rolling median residential transaction price, transaction volume (sales_volume_3yr), benchmark estimated price per square metre (£/sqm), price_basis granularity (postcode, data_zone, outcode_district, or local_authority), dominant property typology, mean internal floor area (avg_floor_area_sqm), and pre-1930 housing share (pre_1930_housing_pct).

1. Census Demographics & Modelled Income Heuristic (ONS Census 2021 E&W; NRS Scotland's Census 2022):

• est_median_household_income_gbp: Heuristic small-area estimate of annual gross disposable household income (clamped £21,000–£95,000 for relative ranking — *not* an observed Census or HMRC survey return).
• Observed Census shares: NS-SeC higher managerial/professional %, Level 4+ and no-qualification rates, housing tenure breakdown (owned outright, mortgaged, private rented, social rented), economically active employed %, retired %, student %, work-from-home %, car ownership (zero_cars, two_or_more_cars), 5 age bands, and population density per km².

1. Statutory Indices of Multiple Deprivation — All 7 Domains:

• National deciles (1 = most deprived 10% within home nation, 10 = least deprived 10%) and overall rank across overall IMD plus all 7 statutory domains: income, employment, education_skills, health, crime_safety, housing_barriers, and living_environment (English IoD 2025, Welsh WIMD 2025, Scottish SIMD 2020v2).
• *Cross-border note:* IMD deciles are calculated separately within England, Wales, and Scotland and are not directly interchangeable across national borders.

1. Domestic EPC Energy Efficiency (MHCLG Open EPC E&W & Scottish Domestic EPC Register):

• Modal current and potential EPC rating bands (A–G) and green retrofit upside summary (retrofit_upside_potential).

1. Ofcom Digital Infrastructure (Connected Nations 2026):

• gigabit_availability_pct: Percentage of domestic premises with access to gigabit-capable broadband (>= 1,000 Mbps, FTTP full fibre or gigabit cable).
• broadband_speed_tier_mbps: Discrete fixed broadband availability tier (350, 120, 80, or 68.5 Mbps baseline) derived from Ofcom availability brackets. *Note: This is a modelled availability tier, not an empirically measured speed-test average; separate FTTP-only and superfast availability percentages are not returned.*

1. Schools Metadata & Straight-Line Proximity (DfE GIAS, Scottish SEED, Welsh Government):

• Nearest primary and nearest secondary school metadata (id, name, phase, gender, religious_character, admissions_policy) with straight-line geodesic distance (distance_km). *Note: Does NOT include statutory school inspection ratings or school admissions catchment boundaries.*

1. Primary Care / GP Proximity & Statutory Ratings (CQC England, PHS/HIS Scotland, NWSSP/HIW Wales):

• nearest_gp_surgery: Nearest registered GP practice/surgery (id, name, care_type, straight-line distance_km, regulator, statutory rating, and inspection_date where available). *Note: Acute hospitals are not returned in API responses.*

1. Rail & Rapid Transit Connectivity (DfT NaPTAN & ORR Table 1410):

• nearest_station and nearest_intercity_hub (id, name, station_type, straight-line geodesic distance_km, and hub_type station hierarchy tier: national_hub, regional_hub, commuter_hub, or local_station derived from ORR Table 1410 usage & Network Rail categories; raw annual passenger counts are not returned).

1. National Landmarks & Special Non-Geographic Context:

• Curated landmark_context flags and demographic distortion notes for major UK royal, civic, diplomatic, and institutional postcodes (e.g., SW1A 1AA), plus British Forces Post Office (BF1) and royal/civic non-geographic postcodes.

---

📐 Transparent Scoring Methodology & Mathematical Formulas

Every synthetic score in Postcode Context is deterministic, grounded in Census 2021/2022 and statutory public registers, and documented below and in the live Data Dictionary:

1. Affluence Score (affluence_score_100)

• Scale: 1 to 100 (100 = Peak Affluence; ~10 points represents ~1 national decile shift).
• Weighting Dimensions:
• 35% Heuristic Modelled Gross Disposable Household Income: Normalized against regional GDHI baseline (£72,000 ceiling, capped at 100), where $\text{Income} = \text{clamp}\left(21000, 95000, \text{round}\left(22000 + 3300 \times (\text{IncomeDecile} - 1) + 260 \times \text{Managerial} + 180 \times \text{L4}\right)\right)$.
• 25% Human Capital: Equal weighting between Level 4+ higher education degree holders (degree_or_higher_level4_plus) and higher managerial/professional occupations (ns_sec_managerial_professional_pct).
• 25% Statutory Deprivation Freedom: Normalized national IMD decile (imd_overall_decile * 10).
• 15% Housing Equity: Share of outright homeownership and mortgaged households (owned_outright + mortgaged).
• Formula: $$\text{Score} = \text{clamp}\left(1, 100, \text{round}\left(0.35 \times \min\left(100, \frac{\text{Income}}{72000} \times 100\right) + 0.25 \times \frac{\text{L4} + \text{Managerial}}{2} + 0.25 \times (\text{IMD} \times 10) + 0.15 \times \text{Homeownership}\right)\right)$$
• Tiers: Ultra-Prime (>=90) | Affluent (75–89) | Mid-Market (50–74) | Modest-Income (30–49) | High-Deprivation (<30).
• Scope Note: Measured at LSOA / Data Zone neighbourhood granularity. Because IMD deciles are relative within England, Wales, and Scotland, cross-border comparisons should rely on underlying Census percentages and property transaction metrics.

2. Family Suitability Score (family_suitability_score_100)

• Scale: 1 to 100 (100 = Optimal Family Environment).
• Weighting Dimensions: