Server definition
- Hash
- sha256:f78b5169cd7f8370a8e02d393221b0bbcef98cb95b7e9f39ce2c911bc5a00f70
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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_postcodes).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"postcodes": {
"description": "List of 2 to 5 distinct Great Britain postcodes to compare side-by-side (e.g. [\"SW1A 1AA\", \"BB7 3BB\"]). Must contain at least 2 distinct postcodes in England, Scotland, or Wales.",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
},
"view": {
"default": "full",
"description": "View slice for returned postcode profiles: \"full\" (complete profile per postcode, default), \"brief\" (or \"summary\"/\"ai\", ~80 tokens per postcode, recommended to minimize context usage alongside comparison ranking), \"property\", \"demographics\", \"education\", \"healthcare\", \"transit\", or \"services\".",
"enum": [
"full",
"brief",
"summary",
"ai",
"property",
"demographics",
"education",
"healthcare",
"transit",
"services",
"schools",
"health",
"transport",
"infrastructure"
],
"type": "string"
}
},
"required": [
"postcodes"
],
"type": "object"
},
"name": "compare_postcodes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"comparison_synthesis": {
"additionalProperties": false,
"properties": {
"comparability_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"fastest_broadband": {
"additionalProperties": false,
"properties": {
"broadband_speed_tier_mbps": {
"type": "number"
},
"median_down_mbps": {
"type": "number"
},
"postcode": {
"type": "string"
}
},
"required": [
"postcode",
"median_down_mbps"
],
"type": "object"
},
"highest_affluence": {
"additionalProperties": false,
"properties": {
"postcode": {
"type": "string"
},
"score": {
"type": "number"
},
"tier": {
"type": "string"
}
},
"required": [
"postcode",
"score",
"tier"
],
"type": "object"
},
"highest_family_score": {
"additionalProperties": false,
"properties": {
"postcode": {
"type": "string"
},
"score": {
"type": "number"
}
},
"required": [
"postcode",
"score"
],
"type": "object"
},
"lowest_crime": {
"additionalProperties": false,
"properties": {
"decile": {
"type": [
"number",
"null"
]
},
"postcode": {
"type": "string"
}
},
"required": [
"postcode",
"decile"
],
"type": "object"
},
"lowest_price_per_sqm": {
"additionalProperties": false,
"properties": {
"postcode": {
"type": "string"
},
"price_per_sqm_gbp": {
"type": [
"number",
"null"
]
}
},
"required": [
"postcode",
"price_per_sqm_gbp"
],
"type": "object"
},
"metrics_summary": {
"items": {
"additionalProperties": false,
"properties": {
"affluence_score_100": {
"type": "number"
},
"affluence_tier": {
"type": "string"
},
"broadband_speed_tier_mbps": {
"description": "Estimated fixed broadband download speed tier in Mbps",
"type": [
"number",
"null"
]
},
"crime_safety_decile": {
"type": [
"number",
"null"
]
},
"family_suitability_score_100": {
"type": "number"
},
"median_down_mbps": {
"description": "Legacy alias for broadband_speed_tier_mbps",
"type": [
"number",
"null"
]
},
"median_house_price_gbp": {
"type": [
"number",
"null"
]
},
"postcode": {
"type": "string"
},
"price_per_sqm_gbp": {
"type": [
"number",
"null"
]
}
},
"required": [
"postcode",
"affluence_score_100",
"affluence_tier",
"crime_safety_decile",
"price_per_sqm_gbp",
"median_house_price_gbp",
"family_suitability_score_100"
],
"type": "object"
},
"type": "array"
},
"scale_directions": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"synthesis_notes": {
"type": "string"
}
},
"required": [
"highest_affluence",
"lowest_crime",
"lowest_price_per_sqm",
"fastest_broadband",
"highest_family_score",
"synthesis_notes"
],
"type": "object"
},
"postcodes": {
"items": {
"additionalProperties": false,
"properties": {
"census_demographics": {
"additionalProperties": false,
"properties": {
"age_distribution_pct": {
"additionalProperties": false,
"properties": {
"age_0_to_15": {
"type": "number"
},
"age_16_to_29": {
"type": "number"
},
"age_30_to_44": {
"type": "number"
},
"age_45_to_64": {
"type": "number"
},
"age_65_plus": {
"type": "number"
}
},
"required": [
"age_0_to_15",
"age_16_to_29",
"age_30_to_44",
"age_45_to_64",
"age_65_plus"
],
"type": "object"
},
"car_ownership_pct": {
"additionalProperties": false,
"properties": {
"two_or_more_cars": {
"type": "number"
},
"zero_cars": {
"type": "number"
}
},
"required": [
"zero_cars",
"two_or_more_cars"
],
"type": "object"
},
"economically_active_employed_pct": {
"type": "number"
},
"est_median_household_income_gbp": {
"description": "Heuristic neighbourhood estimate of annual median gross disposable household income in GBP (LSOA/Data Zone level) derived from a linear formula weighting DWP/HMRC income deprivation deciles, Census NS-SeC managerial occupation shares, and Level 4 qualifications, clamped at £21,000–£95,000. Not an observed Census return.",
"type": "number"
},
"ns_sec_managerial_professional_pct": {
"type": "number"
},
"population_density_per_sqkm": {
"description": "Resident population density per square kilometre from Census 2021 small area boundaries",
"type": "number"
},
"qualifications_pct": {
"additionalProperties": false,
"properties": {
"degree_or_higher_level4_plus": {
"type": "number"
},
"no_qualifications": {
"type": "number"
}
},
"required": [
"degree_or_higher_level4_plus",
"no_qualifications"
],
"type": "object"
},
"retired_pct": {
"type": "number"
},
"student_pct": {
"type": "number"
},
"tenure_breakdown_pct": {
"additionalProperties": false,
"properties": {
"mortgaged": {
"type": "number"
},
"owned_outright": {
"type": "number"
},
"private_rented": {
"type": "number"
},
"social_rented": {
"type": "number"
}
},
"required": [
"owned_outright",
"mortgaged",
"private_rented",
"social_rented"
],
"type": "object"
},
"work_from_home_pct": {
"type": "number"
}
},
"required": [
"population_density_per_sqkm",
"est_median_household_income_gbp",
"tenure_breakdown_pct",
"qualifications_pct",
"ns_sec_managerial_professional_pct",
"economically_active_employed_pct",
"retired_pct",
"student_pct",
"work_from_home_pct",
"car_ownership_pct",
"age_distribution_pct"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"deprivation_deciles": {
"additionalProperties": false,
"properties": {
"_scale_explanation": {
"description": "1 = most deprived 10% nationally, 10 = least deprived 10% nationally",
"type": "string"
},
"crime_safety_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
],
"description": "Statutory Crime Deprivation Decile (1-10) from the English IoD 2025, Welsh WIMD 2025, and Scottish SIMD 2020 (1 = highest recorded crime deprivation nationally, 10 = lowest recorded crime deprivation / safest 10%). Sourced from multi-year police records per capita at LSOA level. Represents neighbourhood historical baseline, not individual personal victimisation risk."
},
"education_skills_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"employment_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"health_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"housing_barriers_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_rank": {
"type": [
"number",
"null"
]
},
"income_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"living_environment_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"_scale_explanation",
"imd_overall_decile",
"imd_overall_rank",
"income_deprivation_decile",
"employment_deprivation_decile",
"education_skills_decile",
"health_deprivation_decile",
"crime_safety_decile",
"housing_barriers_decile",
"living_environment_decile"
],
"type": "object"
},
"digital_infrastructure": {
"additionalProperties": false,
"properties": {
"broadband_speed_tier_mbps": {
"description": "Estimated fixed broadband download speed tier in Mbps (350, 120, 80, or 68.5 Mbps baseline derived from Ofcom Connected Nations availability brackets)",
"type": "number"
},
"gigabit_availability_pct": {
"description": "Ofcom full-fibre / gigabit network coverage percentage",
"type": "number"
},
"median_download_mbps": {
"description": "Median fixed broadband download speed in Mbps (Ofcom Connected Nations)",
"type": "number"
}
},
"required": [
"broadband_speed_tier_mbps",
"gigabit_availability_pct"
],
"type": "object"
},
"healthcare_and_services": {
"additionalProperties": false,
"properties": {
"nearest_gp_surgery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"care_type": {
"description": "Service classification: GP Practice, Hospital, Clinic",
"type": "string"
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"id": {
"description": "CQC or NHS provider/location ID e.g. CQC-1-12687408410",
"type": "string"
},
"inspection_date": {
"description": "Inspection date or last verified date",
"type": [
"string",
"null"
]
},
"name": {
"description": "Facility name (individual managers/partners strictly excluded)",
"type": "string"
},
"rating": {
"description": "Regulatory rating e.g. Outstanding, Good, or null if unrated/pending",
"type": [
"string",
"null"
]
},
"regulator": {
"description": "National healthcare regulator e.g. CQC, HIS, HIW",
"type": "string"
}
},
"required": [
"id",
"name",
"care_type",
"distance_km",
"regulator",
"rating",
"inspection_date"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest GP practice / general practitioner surgery"
}
},
"required": [
"nearest_gp_surgery"
],
"type": "object"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"property_and_energy": {
"additionalProperties": false,
"properties": {
"avg_floor_area_sqm": {
"description": "Mean domestic internal floor area from Open EPC Register",
"type": [
"number",
"null"
]
},
"dominant_property_type": {
"description": "Predominant housing typology (Detached, Semi-Detached, Terraced, Flat/Maisonette)",
"type": [
"string",
"null"
]
},
"epc_rating_current": {
"description": "Modal current EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"epc_rating_potential": {
"description": "Modal potential EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"median_house_price_gbp": {
"description": "HM Land Registry (E&W 2024–2026) and Registers of Scotland (Scotland 2023–2025) 3-year rolling median transaction price in GBP",
"type": [
"number",
"null"
]
},
"pre_1930_housing_pct": {
"description": "Percentage of domestic stock built prior to 1930",
"type": [
"number",
"null"
]
},
"price_basis": {
"additionalProperties": false,
"description": "Spatial resolution and temporal window metadata for the property transaction valuation",
"properties": {
"n": {
"description": "Number of recorded transactions in rolling window used to compute median price",
"type": "number"
},
"resolution": {
"description": "Spatial granularity of the median property valuation",
"enum": [
"postcode",
"data_zone",
"outcode_district",
"local_authority"
],
"type": "string"
},
"window": {
"description": "Rolling temporal transaction window (2024–2026 for England & Wales, 2023–2025 for Scotland)",
"type": "string"
}
},
"required": [
"resolution",
"window",
"n"
],
"type": "object"
},
"price_per_sqm_gbp": {
"description": "Synthetic property valuation benchmark joining 3-year rolling median transaction prices (HMLR / RoS) with domestic mean internal floor areas (Open EPC / Scottish EPC Register) at postcode level",
"type": [
"number",
"null"
]
},
"retrofit_upside_potential": {
"description": "Summary of energy efficiency retrofit potential",
"type": [
"string",
"null"
]
},
"sales_volume_3yr": {
"description": "Transaction volume recorded in 3-year window",
"type": [
"number",
"null"
]
}
},
"required": [
"median_house_price_gbp",
"price_per_sqm_gbp",
"price_basis",
"sales_volume_3yr",
"dominant_property_type",
"avg_floor_area_sqm",
"epc_rating_current",
"epc_rating_potential",
"retrofit_upside_potential",
"pre_1930_housing_pct"
],
"type": "object"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
},
"schools_and_education": {
"additionalProperties": false,
"properties": {
"nearest_primary_school": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"admissions_policy": {
"description": "Admissions policy e.g. Non-selective, Selective",
"type": [
"string",
"null"
]
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"gender": {
"description": "Admissions gender: Mixed, Boys, Girls",
"type": "string"
},
"id": {
"description": "Unique school identifier e.g. ENG-101138, SCO-5507427, WAL-6813350",
"type": "string"
},
"name": {
"description": "Official school name (headteachers/staff names strictly excluded)",
"type": "string"
},
"phase": {
"description": "Educational phase: Primary, Secondary, 16 plus, All-through",
"type": "string"
},
"religious_character": {
"description": "Religious ethos or designation, or null if secular/none",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"phase",
"gender",
"religious_character",
"admissions_policy",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest primary or all-through school"
},
"nearest_secondary_school": {
"anyOf": [
{
"$ref": "#/properties/postcodes/items/properties/schools_and_education/properties/nearest_primary_school/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest secondary or all-through school"
}
},
"required": [
"nearest_primary_school",
"nearest_secondary_school"
],
"type": "object"
},
"summary_for_ai": {
"additionalProperties": false,
"properties": {
"affluence_score_100": {
"description": "Composite socio-economic score from 1 to 100 (weighted: 35% modelled income, 25% human capital qualifications/NS-SeC, 25% IMD deprivation freedom, 15% homeownership equity; ~10 points represents ~1 national decile shift)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"affluence_tier": {
"enum": [
"Ultra-Prime",
"Affluent",
"Mid-Market",
"Modest-Income",
"High-Deprivation"
],
"type": "string"
},
"ai_context_briefing": {
"description": "Pre-synthesised dense natural language summary designed for LLM context window injection",
"type": "string"
},
"b2c_spending_propensity": {
"description": "Inferred neighbourhood consumer expenditure profile derived from local affluence tier and tenure. Represents a macro area characteristic, not an observed financial record of an individual household.",
"type": "string"
},
"commuter_connectivity_score_100": {
"description": "Composite multi-modal connectivity score from 1 to 100 (45% straight-line geodesic distance to nearest rail/rapid transit station, up to +15 pts strategic intercity hub bonus, 20% zero-car transit reliance density, 15% broadband speed tier & gigabit coverage, 10% affluence)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"family_suitability_score_100": {
"description": "Composite family suitability score from 1 to 100 (weighted: 40% statutory crime safety decile, 30% statutory education/skills deprivation decile adjusted by -2 pts/km capped at -20 when nearest school >3km geodesic distance, 30% child and parenting-age demographic density)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"primary_persona_tag": {
"description": "Target marketing / demographic persona archetype",
"type": "string"
},
"property_value_index": {
"description": "Relative property valuation index benchmarked against prime central London baseline (£16,200/sqm ceiling = 100)",
"type": "number"
}
},
"required": [
"ai_context_briefing",
"primary_persona_tag",
"affluence_tier",
"b2c_spending_propensity",
"affluence_score_100",
"family_suitability_score_100",
"commuter_connectivity_score_100",
"property_value_index"
],
"type": "object"
},
"transit": {
"additionalProperties": false,
"properties": {
"nearest_intercity_hub": {
"anyOf": [
{
"$ref": "#/properties/postcodes/items/properties/transit/properties/nearest_station/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest primary national or regional mainline railway hub (>= 2M annual passengers or Network Rail Category A/B interchange)"
},
"nearest_station": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"distance_km": {
"description": "Straight-line distance in kilometres from postcode coordinates",
"type": "number"
},
"hub_type": {
"description": "Station hierarchy tier based on ORR annual passenger footfall and mainline intercity connectivity",
"enum": [
"national_hub",
"regional_hub",
"commuter_hub",
"local_station"
],
"type": "string"
},
"id": {
"description": "NaPTAN station code (e.g. 9100MNCRVIC, 4900ZZLUWSM1)",
"type": "string"
},
"name": {
"description": "Official station name (e.g. Manchester Victoria, Westminster)",
"type": "string"
},
"station_type": {
"description": "Transit network mode (e.g. National Rail, London Underground, DLR, Metro / Tram)",
"type": "string"
}
},
"required": [
"id",
"name",
"station_type",
"hub_type",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest National Rail, London Underground, DLR, or light rail / tram station of any classification"
}
},
"required": [
"nearest_station"
],
"type": "object"
}
},
"required": [
"location"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"postcodes",
"comparison_synthesis",
"_attribution"
],
"type": "object"
}
},
{
"description": "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 side-by-side comparative rankings are required (use compare_postcodes).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"postcodes": {
"description": "Array of 1 to 50 Great Britain postcodes to enrich. 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).",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"view": {
"default": "brief",
"description": "View slice for each postcode in the batch results: \"brief\" (or \"summary\"/\"ai\", ~80 tokens per postcode, default for batch calls to prevent context blow-up), \"full\" (complete 113-metric dataset per postcode, explicitly requested when all metrics needed), \"property\", \"demographics\", \"education\", \"healthcare\", \"transit\", or \"services\".",
"enum": [
"full",
"brief",
"summary",
"ai",
"property",
"demographics",
"education",
"healthcare",
"transit",
"services",
"schools",
"health",
"transport",
"infrastructure"
],
"type": "string"
}
},
"required": [
"postcodes"
],
"type": "object"
},
"name": "enrich_postcodes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"cohort_summary": {
"additionalProperties": false,
"properties": {
"average_affluence_score": {
"type": "number"
},
"average_house_price_gbp": {
"type": "number"
},
"dominant_persona": {
"type": "string"
},
"top_3_highest_value_postcodes": {
"items": {
"additionalProperties": false,
"properties": {
"median_house_price_gbp": {
"type": [
"number",
"null"
]
},
"postcode": {
"type": "string"
}
},
"required": [
"postcode",
"median_house_price_gbp"
],
"type": "object"
},
"type": "array"
},
"total_matched": {
"type": "number"
},
"total_requested": {
"type": "number"
}
},
"required": [
"total_requested",
"total_matched",
"average_affluence_score",
"dominant_persona",
"average_house_price_gbp",
"top_3_highest_value_postcodes"
],
"type": "object"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"census_demographics": {
"additionalProperties": false,
"properties": {
"age_distribution_pct": {
"additionalProperties": false,
"properties": {
"age_0_to_15": {
"type": "number"
},
"age_16_to_29": {
"type": "number"
},
"age_30_to_44": {
"type": "number"
},
"age_45_to_64": {
"type": "number"
},
"age_65_plus": {
"type": "number"
}
},
"required": [
"age_0_to_15",
"age_16_to_29",
"age_30_to_44",
"age_45_to_64",
"age_65_plus"
],
"type": "object"
},
"car_ownership_pct": {
"additionalProperties": false,
"properties": {
"two_or_more_cars": {
"type": "number"
},
"zero_cars": {
"type": "number"
}
},
"required": [
"zero_cars",
"two_or_more_cars"
],
"type": "object"
},
"economically_active_employed_pct": {
"type": "number"
},
"est_median_household_income_gbp": {
"description": "Heuristic neighbourhood estimate of annual median gross disposable household income in GBP (LSOA/Data Zone level) derived from a linear formula weighting DWP/HMRC income deprivation deciles, Census NS-SeC managerial occupation shares, and Level 4 qualifications, clamped at £21,000–£95,000. Not an observed Census return.",
"type": "number"
},
"ns_sec_managerial_professional_pct": {
"type": "number"
},
"population_density_per_sqkm": {
"description": "Resident population density per square kilometre from Census 2021 small area boundaries",
"type": "number"
},
"qualifications_pct": {
"additionalProperties": false,
"properties": {
"degree_or_higher_level4_plus": {
"type": "number"
},
"no_qualifications": {
"type": "number"
}
},
"required": [
"degree_or_higher_level4_plus",
"no_qualifications"
],
"type": "object"
},
"retired_pct": {
"type": "number"
},
"student_pct": {
"type": "number"
},
"tenure_breakdown_pct": {
"additionalProperties": false,
"properties": {
"mortgaged": {
"type": "number"
},
"owned_outright": {
"type": "number"
},
"private_rented": {
"type": "number"
},
"social_rented": {
"type": "number"
}
},
"required": [
"owned_outright",
"mortgaged",
"private_rented",
"social_rented"
],
"type": "object"
},
"work_from_home_pct": {
"type": "number"
}
},
"required": [
"population_density_per_sqkm",
"est_median_household_income_gbp",
"tenure_breakdown_pct",
"qualifications_pct",
"ns_sec_managerial_professional_pct",
"economically_active_employed_pct",
"retired_pct",
"student_pct",
"work_from_home_pct",
"car_ownership_pct",
"age_distribution_pct"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"deprivation_deciles": {
"additionalProperties": false,
"properties": {
"_scale_explanation": {
"description": "1 = most deprived 10% nationally, 10 = least deprived 10% nationally",
"type": "string"
},
"crime_safety_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
],
"description": "Statutory Crime Deprivation Decile (1-10) from the English IoD 2025, Welsh WIMD 2025, and Scottish SIMD 2020 (1 = highest recorded crime deprivation nationally, 10 = lowest recorded crime deprivation / safest 10%). Sourced from multi-year police records per capita at LSOA level. Represents neighbourhood historical baseline, not individual personal victimisation risk."
},
"education_skills_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"employment_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"health_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"housing_barriers_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_rank": {
"type": [
"number",
"null"
]
},
"income_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"living_environment_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"_scale_explanation",
"imd_overall_decile",
"imd_overall_rank",
"income_deprivation_decile",
"employment_deprivation_decile",
"education_skills_decile",
"health_deprivation_decile",
"crime_safety_decile",
"housing_barriers_decile",
"living_environment_decile"
],
"type": "object"
},
"digital_infrastructure": {
"additionalProperties": false,
"properties": {
"broadband_speed_tier_mbps": {
"description": "Estimated fixed broadband download speed tier in Mbps (350, 120, 80, or 68.5 Mbps baseline derived from Ofcom Connected Nations availability brackets)",
"type": "number"
},
"gigabit_availability_pct": {
"description": "Ofcom full-fibre / gigabit network coverage percentage",
"type": "number"
},
"median_download_mbps": {
"description": "Median fixed broadband download speed in Mbps (Ofcom Connected Nations)",
"type": "number"
}
},
"required": [
"broadband_speed_tier_mbps",
"gigabit_availability_pct"
],
"type": "object"
},
"healthcare_and_services": {
"additionalProperties": false,
"properties": {
"nearest_gp_surgery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"care_type": {
"description": "Service classification: GP Practice, Hospital, Clinic",
"type": "string"
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"id": {
"description": "CQC or NHS provider/location ID e.g. CQC-1-12687408410",
"type": "string"
},
"inspection_date": {
"description": "Inspection date or last verified date",
"type": [
"string",
"null"
]
},
"name": {
"description": "Facility name (individual managers/partners strictly excluded)",
"type": "string"
},
"rating": {
"description": "Regulatory rating e.g. Outstanding, Good, or null if unrated/pending",
"type": [
"string",
"null"
]
},
"regulator": {
"description": "National healthcare regulator e.g. CQC, HIS, HIW",
"type": "string"
}
},
"required": [
"id",
"name",
"care_type",
"distance_km",
"regulator",
"rating",
"inspection_date"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest GP practice / general practitioner surgery"
}
},
"required": [
"nearest_gp_surgery"
],
"type": "object"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"property_and_energy": {
"additionalProperties": false,
"properties": {
"avg_floor_area_sqm": {
"description": "Mean domestic internal floor area from Open EPC Register",
"type": [
"number",
"null"
]
},
"dominant_property_type": {
"description": "Predominant housing typology (Detached, Semi-Detached, Terraced, Flat/Maisonette)",
"type": [
"string",
"null"
]
},
"epc_rating_current": {
"description": "Modal current EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"epc_rating_potential": {
"description": "Modal potential EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"median_house_price_gbp": {
"description": "HM Land Registry (E&W 2024–2026) and Registers of Scotland (Scotland 2023–2025) 3-year rolling median transaction price in GBP",
"type": [
"number",
"null"
]
},
"pre_1930_housing_pct": {
"description": "Percentage of domestic stock built prior to 1930",
"type": [
"number",
"null"
]
},
"price_basis": {
"additionalProperties": false,
"description": "Spatial resolution and temporal window metadata for the property transaction valuation",
"properties": {
"n": {
"description": "Number of recorded transactions in rolling window used to compute median price",
"type": "number"
},
"resolution": {
"description": "Spatial granularity of the median property valuation",
"enum": [
"postcode",
"data_zone",
"outcode_district",
"local_authority"
],
"type": "string"
},
"window": {
"description": "Rolling temporal transaction window (2024–2026 for England & Wales, 2023–2025 for Scotland)",
"type": "string"
}
},
"required": [
"resolution",
"window",
"n"
],
"type": "object"
},
"price_per_sqm_gbp": {
"description": "Synthetic property valuation benchmark joining 3-year rolling median transaction prices (HMLR / RoS) with domestic mean internal floor areas (Open EPC / Scottish EPC Register) at postcode level",
"type": [
"number",
"null"
]
},
"retrofit_upside_potential": {
"description": "Summary of energy efficiency retrofit potential",
"type": [
"string",
"null"
]
},
"sales_volume_3yr": {
"description": "Transaction volume recorded in 3-year window",
"type": [
"number",
"null"
]
}
},
"required": [
"median_house_price_gbp",
"price_per_sqm_gbp",
"price_basis",
"sales_volume_3yr",
"dominant_property_type",
"avg_floor_area_sqm",
"epc_rating_current",
"epc_rating_potential",
"retrofit_upside_potential",
"pre_1930_housing_pct"
],
"type": "object"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
},
"schools_and_education": {
"additionalProperties": false,
"properties": {
"nearest_primary_school": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"admissions_policy": {
"description": "Admissions policy e.g. Non-selective, Selective",
"type": [
"string",
"null"
]
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"gender": {
"description": "Admissions gender: Mixed, Boys, Girls",
"type": "string"
},
"id": {
"description": "Unique school identifier e.g. ENG-101138, SCO-5507427, WAL-6813350",
"type": "string"
},
"name": {
"description": "Official school name (headteachers/staff names strictly excluded)",
"type": "string"
},
"phase": {
"description": "Educational phase: Primary, Secondary, 16 plus, All-through",
"type": "string"
},
"religious_character": {
"description": "Religious ethos or designation, or null if secular/none",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"phase",
"gender",
"religious_character",
"admissions_policy",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest primary or all-through school"
},
"nearest_secondary_school": {
"anyOf": [
{
"$ref": "#/properties/results/items/properties/schools_and_education/properties/nearest_primary_school/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest secondary or all-through school"
}
},
"required": [
"nearest_primary_school",
"nearest_secondary_school"
],
"type": "object"
},
"summary_for_ai": {
"additionalProperties": false,
"properties": {
"affluence_score_100": {
"description": "Composite socio-economic score from 1 to 100 (weighted: 35% modelled income, 25% human capital qualifications/NS-SeC, 25% IMD deprivation freedom, 15% homeownership equity; ~10 points represents ~1 national decile shift)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"affluence_tier": {
"enum": [
"Ultra-Prime",
"Affluent",
"Mid-Market",
"Modest-Income",
"High-Deprivation"
],
"type": "string"
},
"ai_context_briefing": {
"description": "Pre-synthesised dense natural language summary designed for LLM context window injection",
"type": "string"
},
"b2c_spending_propensity": {
"description": "Inferred neighbourhood consumer expenditure profile derived from local affluence tier and tenure. Represents a macro area characteristic, not an observed financial record of an individual household.",
"type": "string"
},
"commuter_connectivity_score_100": {
"description": "Composite multi-modal connectivity score from 1 to 100 (45% straight-line geodesic distance to nearest rail/rapid transit station, up to +15 pts strategic intercity hub bonus, 20% zero-car transit reliance density, 15% broadband speed tier & gigabit coverage, 10% affluence)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"family_suitability_score_100": {
"description": "Composite family suitability score from 1 to 100 (weighted: 40% statutory crime safety decile, 30% statutory education/skills deprivation decile adjusted by -2 pts/km capped at -20 when nearest school >3km geodesic distance, 30% child and parenting-age demographic density)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"primary_persona_tag": {
"description": "Target marketing / demographic persona archetype",
"type": "string"
},
"property_value_index": {
"description": "Relative property valuation index benchmarked against prime central London baseline (£16,200/sqm ceiling = 100)",
"type": "number"
}
},
"required": [
"ai_context_briefing",
"primary_persona_tag",
"affluence_tier",
"b2c_spending_propensity",
"affluence_score_100",
"family_suitability_score_100",
"commuter_connectivity_score_100",
"property_value_index"
],
"type": "object"
},
"transit": {
"additionalProperties": false,
"properties": {
"nearest_intercity_hub": {
"anyOf": [
{
"$ref": "#/properties/results/items/properties/transit/properties/nearest_station/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest primary national or regional mainline railway hub (>= 2M annual passengers or Network Rail Category A/B interchange)"
},
"nearest_station": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"distance_km": {
"description": "Straight-line distance in kilometres from postcode coordinates",
"type": "number"
},
"hub_type": {
"description": "Station hierarchy tier based on ORR annual passenger footfall and mainline intercity connectivity",
"enum": [
"national_hub",
"regional_hub",
"commuter_hub",
"local_station"
],
"type": "string"
},
"id": {
"description": "NaPTAN station code (e.g. 9100MNCRVIC, 4900ZZLUWSM1)",
"type": "string"
},
"name": {
"description": "Official station name (e.g. Manchester Victoria, Westminster)",
"type": "string"
},
"station_type": {
"description": "Transit network mode (e.g. National Rail, London Underground, DLR, Metro / Tram)",
"type": "string"
}
},
"required": [
"id",
"name",
"station_type",
"hub_type",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest National Rail, London Underground, DLR, or light rail / tram station of any classification"
}
},
"required": [
"nearest_station"
],
"type": "object"
}
},
"required": [
"location"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results",
"cohort_summary",
"_attribution"
],
"type": "object"
}
},
{
"description": "$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 Government, DfE, CQC, PHS, NWSSP, DfT, ORR).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_data_attribution",
"outputSchema": null
},
{
"description": "$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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"default": "summary_for_ai",
"description": "Statistical domain category filter. Use \"summary_for_ai\" (default) for a compact token-efficient overview (~8 fields) for AI agents, or \"all\" for the complete 113-metric specification.",
"enum": [
"all",
"summary_for_ai",
"property_and_energy",
"deprivation_deciles",
"census_demographics",
"digital_infrastructure",
"location",
"query_and_fallbacks",
"landmark_context",
"schools_and_education",
"education_and_schools",
"healthcare_and_services",
"transit"
],
"type": "string"
},
"field": {
"description": "Optional specific field name to inspect (e.g. affluence_score_100, median_house_price_gbp, family_suitability_score_100).",
"type": "string"
}
},
"type": "object"
},
"name": "get_data_dictionary",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"postcode": {
"description": "Great Britain unit postcode to inspect for Census demographics and statutory IMD deprivation deciles (e.g. SW1A 1AA, BB7 3BB, EH1 1YZ, CF10 1EP). Space-optional, case-insensitive.",
"type": "string"
}
},
"required": [
"postcode"
],
"type": "object"
},
"name": "get_demographics_and_deprivation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"census_demographics": {
"additionalProperties": false,
"properties": {
"age_distribution_pct": {
"additionalProperties": false,
"properties": {
"age_0_to_15": {
"type": "number"
},
"age_16_to_29": {
"type": "number"
},
"age_30_to_44": {
"type": "number"
},
"age_45_to_64": {
"type": "number"
},
"age_65_plus": {
"type": "number"
}
},
"required": [
"age_0_to_15",
"age_16_to_29",
"age_30_to_44",
"age_45_to_64",
"age_65_plus"
],
"type": "object"
},
"car_ownership_pct": {
"additionalProperties": false,
"properties": {
"two_or_more_cars": {
"type": "number"
},
"zero_cars": {
"type": "number"
}
},
"required": [
"zero_cars",
"two_or_more_cars"
],
"type": "object"
},
"economically_active_employed_pct": {
"type": "number"
},
"est_median_household_income_gbp": {
"description": "Heuristic neighbourhood estimate of annual median gross disposable household income in GBP (LSOA/Data Zone level) derived from a linear formula weighting DWP/HMRC income deprivation deciles, Census NS-SeC managerial occupation shares, and Level 4 qualifications, clamped at £21,000–£95,000. Not an observed Census return.",
"type": "number"
},
"ns_sec_managerial_professional_pct": {
"type": "number"
},
"population_density_per_sqkm": {
"description": "Resident population density per square kilometre from Census 2021 small area boundaries",
"type": "number"
},
"qualifications_pct": {
"additionalProperties": false,
"properties": {
"degree_or_higher_level4_plus": {
"type": "number"
},
"no_qualifications": {
"type": "number"
}
},
"required": [
"degree_or_higher_level4_plus",
"no_qualifications"
],
"type": "object"
},
"retired_pct": {
"type": "number"
},
"student_pct": {
"type": "number"
},
"tenure_breakdown_pct": {
"additionalProperties": false,
"properties": {
"mortgaged": {
"type": "number"
},
"owned_outright": {
"type": "number"
},
"private_rented": {
"type": "number"
},
"social_rented": {
"type": "number"
}
},
"required": [
"owned_outright",
"mortgaged",
"private_rented",
"social_rented"
],
"type": "object"
},
"work_from_home_pct": {
"type": "number"
}
},
"required": [
"population_density_per_sqkm",
"est_median_household_income_gbp",
"tenure_breakdown_pct",
"qualifications_pct",
"ns_sec_managerial_professional_pct",
"economically_active_employed_pct",
"retired_pct",
"student_pct",
"work_from_home_pct",
"car_ownership_pct",
"age_distribution_pct"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"deprivation_deciles": {
"additionalProperties": false,
"properties": {
"_scale_explanation": {
"description": "1 = most deprived 10% nationally, 10 = least deprived 10% nationally",
"type": "string"
},
"crime_safety_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
],
"description": "Statutory Crime Deprivation Decile (1-10) from the English IoD 2025, Welsh WIMD 2025, and Scottish SIMD 2020 (1 = highest recorded crime deprivation nationally, 10 = lowest recorded crime deprivation / safest 10%). Sourced from multi-year police records per capita at LSOA level. Represents neighbourhood historical baseline, not individual personal victimisation risk."
},
"education_skills_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"employment_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"health_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"housing_barriers_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_rank": {
"type": [
"number",
"null"
]
},
"income_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"living_environment_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"_scale_explanation",
"imd_overall_decile",
"imd_overall_rank",
"income_deprivation_decile",
"employment_deprivation_decile",
"education_skills_decile",
"health_deprivation_decile",
"crime_safety_decile",
"housing_barriers_decile",
"living_environment_decile"
],
"type": "object"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
}
},
"required": [
"location",
"deprivation_deciles",
"census_demographics",
"_attribution"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"postcode": {
"description": "Great Britain unit postcode to summarize (e.g. SW1A 1AA, BB7 3BB, EH1 1YZ, CF10 1EP). Space-optional, case-insensitive. Returns ~80 tokens of concise natural language context for LLM agents.",
"type": "string"
}
},
"required": [
"postcode"
],
"type": "object"
},
"name": "get_postcode_ai_brief",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
},
"summary_for_ai": {
"additionalProperties": false,
"properties": {
"affluence_score_100": {
"description": "Composite socio-economic score from 1 to 100 (weighted: 35% modelled income, 25% human capital qualifications/NS-SeC, 25% IMD deprivation freedom, 15% homeownership equity; ~10 points represents ~1 national decile shift)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"affluence_tier": {
"enum": [
"Ultra-Prime",
"Affluent",
"Mid-Market",
"Modest-Income",
"High-Deprivation"
],
"type": "string"
},
"ai_context_briefing": {
"description": "Pre-synthesised dense natural language summary designed for LLM context window injection",
"type": "string"
},
"b2c_spending_propensity": {
"description": "Inferred neighbourhood consumer expenditure profile derived from local affluence tier and tenure. Represents a macro area characteristic, not an observed financial record of an individual household.",
"type": "string"
},
"commuter_connectivity_score_100": {
"description": "Composite multi-modal connectivity score from 1 to 100 (45% straight-line geodesic distance to nearest rail/rapid transit station, up to +15 pts strategic intercity hub bonus, 20% zero-car transit reliance density, 15% broadband speed tier & gigabit coverage, 10% affluence)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"family_suitability_score_100": {
"description": "Composite family suitability score from 1 to 100 (weighted: 40% statutory crime safety decile, 30% statutory education/skills deprivation decile adjusted by -2 pts/km capped at -20 when nearest school >3km geodesic distance, 30% child and parenting-age demographic density)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"primary_persona_tag": {
"description": "Target marketing / demographic persona archetype",
"type": "string"
},
"property_value_index": {
"description": "Relative property valuation index benchmarked against prime central London baseline (£16,200/sqm ceiling = 100)",
"type": "number"
}
},
"required": [
"ai_context_briefing",
"primary_persona_tag",
"affluence_tier",
"b2c_spending_propensity",
"affluence_score_100",
"family_suitability_score_100",
"commuter_connectivity_score_100",
"property_value_index"
],
"type": "object"
}
},
"required": [
"summary_for_ai",
"location",
"_attribution"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"postcode": {
"description": "Great Britain unit postcode to inspect for real estate transactions, £/sqm, and EPC ratings (e.g. SW1A 1AA, BB7 3BB, EH1 1YZ, CF10 1EP). Space-optional, case-insensitive.",
"type": "string"
}
},
"required": [
"postcode"
],
"type": "object"
},
"name": "get_property_and_energy_profile",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"digital_infrastructure": {
"additionalProperties": false,
"properties": {
"broadband_speed_tier_mbps": {
"description": "Estimated fixed broadband download speed tier in Mbps (350, 120, 80, or 68.5 Mbps baseline derived from Ofcom Connected Nations availability brackets)",
"type": "number"
},
"gigabit_availability_pct": {
"description": "Ofcom full-fibre / gigabit network coverage percentage",
"type": "number"
},
"median_download_mbps": {
"description": "Median fixed broadband download speed in Mbps (Ofcom Connected Nations)",
"type": "number"
}
},
"required": [
"broadband_speed_tier_mbps",
"gigabit_availability_pct"
],
"type": "object"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"property_and_energy": {
"additionalProperties": false,
"properties": {
"avg_floor_area_sqm": {
"description": "Mean domestic internal floor area from Open EPC Register",
"type": [
"number",
"null"
]
},
"dominant_property_type": {
"description": "Predominant housing typology (Detached, Semi-Detached, Terraced, Flat/Maisonette)",
"type": [
"string",
"null"
]
},
"epc_rating_current": {
"description": "Modal current EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"epc_rating_potential": {
"description": "Modal potential EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"median_house_price_gbp": {
"description": "HM Land Registry (E&W 2024–2026) and Registers of Scotland (Scotland 2023–2025) 3-year rolling median transaction price in GBP",
"type": [
"number",
"null"
]
},
"pre_1930_housing_pct": {
"description": "Percentage of domestic stock built prior to 1930",
"type": [
"number",
"null"
]
},
"price_basis": {
"additionalProperties": false,
"description": "Spatial resolution and temporal window metadata for the property transaction valuation",
"properties": {
"n": {
"description": "Number of recorded transactions in rolling window used to compute median price",
"type": "number"
},
"resolution": {
"description": "Spatial granularity of the median property valuation",
"enum": [
"postcode",
"data_zone",
"outcode_district",
"local_authority"
],
"type": "string"
},
"window": {
"description": "Rolling temporal transaction window (2024–2026 for England & Wales, 2023–2025 for Scotland)",
"type": "string"
}
},
"required": [
"resolution",
"window",
"n"
],
"type": "object"
},
"price_per_sqm_gbp": {
"description": "Synthetic property valuation benchmark joining 3-year rolling median transaction prices (HMLR / RoS) with domestic mean internal floor areas (Open EPC / Scottish EPC Register) at postcode level",
"type": [
"number",
"null"
]
},
"retrofit_upside_potential": {
"description": "Summary of energy efficiency retrofit potential",
"type": [
"string",
"null"
]
},
"sales_volume_3yr": {
"description": "Transaction volume recorded in 3-year window",
"type": [
"number",
"null"
]
}
},
"required": [
"median_house_price_gbp",
"price_per_sqm_gbp",
"price_basis",
"sales_volume_3yr",
"dominant_property_type",
"avg_floor_area_sqm",
"epc_rating_current",
"epc_rating_potential",
"retrofit_upside_potential",
"pre_1930_housing_pct"
],
"type": "object"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
}
},
"required": [
"location",
"property_and_energy",
"digital_infrastructure",
"_attribution"
],
"type": "object"
}
},
{
"description": "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 (use compare_postcodes instead).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"exclude": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
],
"description": "Optional domain(s) to exclude: \"schools\", \"healthcare\", \"transit\" as a comma-separated string (e.g. \"schools, healthcare\") or an array of strings (e.g. [\"schools\", \"healthcare\"]). Note: exclude only applies when view=\"full\"; ignored if a specific view slice is selected."
},
"postcode": {
"description": "Great Britain unit postcode to analyze (e.g. SW1A 1AA, BB7 3BB, M1 1AE, EH1 1YZ, CF10 1EP). Space-optional, case-insensitive. Covers England, Scotland, and Wales.",
"type": "string"
},
"view": {
"default": "full",
"description": "View slice to return: \"full\" (complete 113-metric profile, default), \"brief\" (or \"summary\"/\"ai\", ~80 tokens summary with AI affluence tier & persona, recommended for token efficiency), \"property\" (prices & EPC), \"demographics\" (Census & IMD deciles), \"education\" (or \"schools\"), \"healthcare\" (or \"health\"), \"transit\" (or \"transport\"), or \"services\" (or \"infrastructure\").",
"enum": [
"full",
"brief",
"summary",
"ai",
"property",
"demographics",
"education",
"healthcare",
"transit",
"services",
"schools",
"health",
"transport",
"infrastructure"
],
"type": "string"
}
},
"required": [
"postcode"
],
"type": "object"
},
"name": "lookup_postcode",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"census_demographics": {
"additionalProperties": false,
"properties": {
"age_distribution_pct": {
"additionalProperties": false,
"properties": {
"age_0_to_15": {
"type": "number"
},
"age_16_to_29": {
"type": "number"
},
"age_30_to_44": {
"type": "number"
},
"age_45_to_64": {
"type": "number"
},
"age_65_plus": {
"type": "number"
}
},
"required": [
"age_0_to_15",
"age_16_to_29",
"age_30_to_44",
"age_45_to_64",
"age_65_plus"
],
"type": "object"
},
"car_ownership_pct": {
"additionalProperties": false,
"properties": {
"two_or_more_cars": {
"type": "number"
},
"zero_cars": {
"type": "number"
}
},
"required": [
"zero_cars",
"two_or_more_cars"
],
"type": "object"
},
"economically_active_employed_pct": {
"type": "number"
},
"est_median_household_income_gbp": {
"description": "Heuristic neighbourhood estimate of annual median gross disposable household income in GBP (LSOA/Data Zone level) derived from a linear formula weighting DWP/HMRC income deprivation deciles, Census NS-SeC managerial occupation shares, and Level 4 qualifications, clamped at £21,000–£95,000. Not an observed Census return.",
"type": "number"
},
"ns_sec_managerial_professional_pct": {
"type": "number"
},
"population_density_per_sqkm": {
"description": "Resident population density per square kilometre from Census 2021 small area boundaries",
"type": "number"
},
"qualifications_pct": {
"additionalProperties": false,
"properties": {
"degree_or_higher_level4_plus": {
"type": "number"
},
"no_qualifications": {
"type": "number"
}
},
"required": [
"degree_or_higher_level4_plus",
"no_qualifications"
],
"type": "object"
},
"retired_pct": {
"type": "number"
},
"student_pct": {
"type": "number"
},
"tenure_breakdown_pct": {
"additionalProperties": false,
"properties": {
"mortgaged": {
"type": "number"
},
"owned_outright": {
"type": "number"
},
"private_rented": {
"type": "number"
},
"social_rented": {
"type": "number"
}
},
"required": [
"owned_outright",
"mortgaged",
"private_rented",
"social_rented"
],
"type": "object"
},
"work_from_home_pct": {
"type": "number"
}
},
"required": [
"population_density_per_sqkm",
"est_median_household_income_gbp",
"tenure_breakdown_pct",
"qualifications_pct",
"ns_sec_managerial_professional_pct",
"economically_active_employed_pct",
"retired_pct",
"student_pct",
"work_from_home_pct",
"car_ownership_pct",
"age_distribution_pct"
],
"type": "object"
},
"confidence": {
"enum": [
"exact",
"approximate"
],
"type": "string"
},
"deprivation_deciles": {
"additionalProperties": false,
"properties": {
"_scale_explanation": {
"description": "1 = most deprived 10% nationally, 10 = least deprived 10% nationally",
"type": "string"
},
"crime_safety_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
],
"description": "Statutory Crime Deprivation Decile (1-10) from the English IoD 2025, Welsh WIMD 2025, and Scottish SIMD 2020 (1 = highest recorded crime deprivation nationally, 10 = lowest recorded crime deprivation / safest 10%). Sourced from multi-year police records per capita at LSOA level. Represents neighbourhood historical baseline, not individual personal victimisation risk."
},
"education_skills_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"employment_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"health_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"housing_barriers_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"imd_overall_rank": {
"type": [
"number",
"null"
]
},
"income_deprivation_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
},
"living_environment_decile": {
"anyOf": [
{
"maximum": 10,
"minimum": 1,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"_scale_explanation",
"imd_overall_decile",
"imd_overall_rank",
"income_deprivation_decile",
"employment_deprivation_decile",
"education_skills_decile",
"health_deprivation_decile",
"crime_safety_decile",
"housing_barriers_decile",
"living_environment_decile"
],
"type": "object"
},
"digital_infrastructure": {
"additionalProperties": false,
"properties": {
"broadband_speed_tier_mbps": {
"description": "Estimated fixed broadband download speed tier in Mbps (350, 120, 80, or 68.5 Mbps baseline derived from Ofcom Connected Nations availability brackets)",
"type": "number"
},
"gigabit_availability_pct": {
"description": "Ofcom full-fibre / gigabit network coverage percentage",
"type": "number"
},
"median_download_mbps": {
"description": "Median fixed broadband download speed in Mbps (Ofcom Connected Nations)",
"type": "number"
}
},
"required": [
"broadband_speed_tier_mbps",
"gigabit_availability_pct"
],
"type": "object"
},
"healthcare_and_services": {
"additionalProperties": false,
"properties": {
"nearest_gp_surgery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"care_type": {
"description": "Service classification: GP Practice, Hospital, Clinic",
"type": "string"
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"id": {
"description": "CQC or NHS provider/location ID e.g. CQC-1-12687408410",
"type": "string"
},
"inspection_date": {
"description": "Inspection date or last verified date",
"type": [
"string",
"null"
]
},
"name": {
"description": "Facility name (individual managers/partners strictly excluded)",
"type": "string"
},
"rating": {
"description": "Regulatory rating e.g. Outstanding, Good, or null if unrated/pending",
"type": [
"string",
"null"
]
},
"regulator": {
"description": "National healthcare regulator e.g. CQC, HIS, HIW",
"type": "string"
}
},
"required": [
"id",
"name",
"care_type",
"distance_km",
"regulator",
"rating",
"inspection_date"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest GP practice / general practitioner surgery"
}
},
"required": [
"nearest_gp_surgery"
],
"type": "object"
},
"landmark_context": {
"additionalProperties": false,
"properties": {
"demographic_distortion_note": {
"description": "Explanation of divergence between the landmark and surrounding small-area residential census population",
"type": "string"
},
"is_national_landmark": {
"description": "True if this postcode represents a major national landmark, royal palace, civic seat, or special non-geographic entity",
"type": "boolean"
},
"landmark_category": {
"description": "Category classification of the landmark or exceptional entity",
"enum": [
"Royal Residence",
"Government & Executive",
"Parliamentary & Civic",
"National Defence & Security",
"Central Banking & Financial",
"National Heritage & Cathedral",
"Diplomatic & Embassy",
"Academic & Historic Seat",
"Healthcare & Medical Research",
"Correctional & Institutional",
"National Sports & Culture",
"Major Transport Hub",
"Special Non-Geographic",
"Military Overseas & BFPO"
],
"type": "string"
},
"landmark_name": {
"description": "Official name of the landmark (e.g. Buckingham Palace, 10 Downing Street)",
"type": "string"
}
},
"required": [
"is_national_landmark",
"landmark_name",
"landmark_category",
"demographic_distortion_note"
],
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"clean_postcode": {
"description": "Normalised uppercase postcode without spaces",
"type": "string"
},
"constituency": {
"description": "UK Parliamentary Constituency",
"type": "string"
},
"incode": {
"description": "Inward code (e.g. 1AA)",
"type": "string"
},
"latitude": {
"description": "WGS84 Latitude",
"type": "number"
},
"local_authority": {
"description": "Local Authority / District Council name",
"type": "string"
},
"longitude": {
"description": "WGS84 Longitude",
"type": "number"
},
"lsoa_code": {
"description": "2021 Census Lower Layer Super Output Area code or Data Zone",
"type": "string"
},
"lsoa_name": {
"description": "Official LSOA / Data Zone name",
"type": "string"
},
"msoa_code": {
"description": "2021 Census Middle Layer Super Output Area code",
"type": "string"
},
"outcode": {
"description": "Outward code (e.g. BB7, SW1A, EH1, CF10)",
"type": "string"
},
"postcode": {
"description": "Standard formatted Great Britain postcode with space",
"type": "string"
},
"region_or_nation": {
"description": "Great Britain Region or Sovereign Nation (England, Scotland, Wales)",
"type": "string"
},
"rural_urban_classification": {
"description": "DEFRA Rural/Urban classification",
"type": "string"
}
},
"required": [
"postcode",
"clean_postcode",
"outcode",
"incode",
"lsoa_code",
"msoa_code",
"lsoa_name",
"local_authority",
"constituency",
"region_or_nation",
"rural_urban_classification",
"latitude",
"longitude"
],
"type": "object"
},
"match_type": {
"enum": [
"exact_unit",
"district_fallback"
],
"type": "string"
},
"note": {
"type": "string"
},
"property_and_energy": {
"additionalProperties": false,
"properties": {
"avg_floor_area_sqm": {
"description": "Mean domestic internal floor area from Open EPC Register",
"type": [
"number",
"null"
]
},
"dominant_property_type": {
"description": "Predominant housing typology (Detached, Semi-Detached, Terraced, Flat/Maisonette)",
"type": [
"string",
"null"
]
},
"epc_rating_current": {
"description": "Modal current EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"epc_rating_potential": {
"description": "Modal potential EPC energy efficiency band (A-G)",
"type": [
"string",
"null"
]
},
"median_house_price_gbp": {
"description": "HM Land Registry (E&W 2024–2026) and Registers of Scotland (Scotland 2023–2025) 3-year rolling median transaction price in GBP",
"type": [
"number",
"null"
]
},
"pre_1930_housing_pct": {
"description": "Percentage of domestic stock built prior to 1930",
"type": [
"number",
"null"
]
},
"price_basis": {
"additionalProperties": false,
"description": "Spatial resolution and temporal window metadata for the property transaction valuation",
"properties": {
"n": {
"description": "Number of recorded transactions in rolling window used to compute median price",
"type": "number"
},
"resolution": {
"description": "Spatial granularity of the median property valuation",
"enum": [
"postcode",
"data_zone",
"outcode_district",
"local_authority"
],
"type": "string"
},
"window": {
"description": "Rolling temporal transaction window (2024–2026 for England & Wales, 2023–2025 for Scotland)",
"type": "string"
}
},
"required": [
"resolution",
"window",
"n"
],
"type": "object"
},
"price_per_sqm_gbp": {
"description": "Synthetic property valuation benchmark joining 3-year rolling median transaction prices (HMLR / RoS) with domestic mean internal floor areas (Open EPC / Scottish EPC Register) at postcode level",
"type": [
"number",
"null"
]
},
"retrofit_upside_potential": {
"description": "Summary of energy efficiency retrofit potential",
"type": [
"string",
"null"
]
},
"sales_volume_3yr": {
"description": "Transaction volume recorded in 3-year window",
"type": [
"number",
"null"
]
}
},
"required": [
"median_house_price_gbp",
"price_per_sqm_gbp",
"price_basis",
"sales_volume_3yr",
"dominant_property_type",
"avg_floor_area_sqm",
"epc_rating_current",
"epc_rating_potential",
"retrofit_upside_potential",
"pre_1930_housing_pct"
],
"type": "object"
},
"requested_postcode": {
"type": "string"
},
"resolved_district": {
"type": "string"
},
"schools_and_education": {
"additionalProperties": false,
"properties": {
"nearest_primary_school": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"admissions_policy": {
"description": "Admissions policy e.g. Non-selective, Selective",
"type": [
"string",
"null"
]
},
"distance_km": {
"description": "Straight-line distance in kilometers from postcode coordinates",
"type": "number"
},
"gender": {
"description": "Admissions gender: Mixed, Boys, Girls",
"type": "string"
},
"id": {
"description": "Unique school identifier e.g. ENG-101138, SCO-5507427, WAL-6813350",
"type": "string"
},
"name": {
"description": "Official school name (headteachers/staff names strictly excluded)",
"type": "string"
},
"phase": {
"description": "Educational phase: Primary, Secondary, 16 plus, All-through",
"type": "string"
},
"religious_character": {
"description": "Religious ethos or designation, or null if secular/none",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"phase",
"gender",
"religious_character",
"admissions_policy",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest primary or all-through school"
},
"nearest_secondary_school": {
"anyOf": [
{
"$ref": "#/properties/schools_and_education/properties/nearest_primary_school/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest secondary or all-through school"
}
},
"required": [
"nearest_primary_school",
"nearest_secondary_school"
],
"type": "object"
},
"summary_for_ai": {
"additionalProperties": false,
"properties": {
"affluence_score_100": {
"description": "Composite socio-economic score from 1 to 100 (weighted: 35% modelled income, 25% human capital qualifications/NS-SeC, 25% IMD deprivation freedom, 15% homeownership equity; ~10 points represents ~1 national decile shift)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"affluence_tier": {
"enum": [
"Ultra-Prime",
"Affluent",
"Mid-Market",
"Modest-Income",
"High-Deprivation"
],
"type": "string"
},
"ai_context_briefing": {
"description": "Pre-synthesised dense natural language summary designed for LLM context window injection",
"type": "string"
},
"b2c_spending_propensity": {
"description": "Inferred neighbourhood consumer expenditure profile derived from local affluence tier and tenure. Represents a macro area characteristic, not an observed financial record of an individual household.",
"type": "string"
},
"commuter_connectivity_score_100": {
"description": "Composite multi-modal connectivity score from 1 to 100 (45% straight-line geodesic distance to nearest rail/rapid transit station, up to +15 pts strategic intercity hub bonus, 20% zero-car transit reliance density, 15% broadband speed tier & gigabit coverage, 10% affluence)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"family_suitability_score_100": {
"description": "Composite family suitability score from 1 to 100 (weighted: 40% statutory crime safety decile, 30% statutory education/skills deprivation decile adjusted by -2 pts/km capped at -20 when nearest school >3km geodesic distance, 30% child and parenting-age demographic density)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"primary_persona_tag": {
"description": "Target marketing / demographic persona archetype",
"type": "string"
},
"property_value_index": {
"description": "Relative property valuation index benchmarked against prime central London baseline (£16,200/sqm ceiling = 100)",
"type": "number"
}
},
"required": [
"ai_context_briefing",
"primary_persona_tag",
"affluence_tier",
"b2c_spending_propensity",
"affluence_score_100",
"family_suitability_score_100",
"commuter_connectivity_score_100",
"property_value_index"
],
"type": "object"
},
"transit": {
"additionalProperties": false,
"properties": {
"nearest_intercity_hub": {
"anyOf": [
{
"$ref": "#/properties/transit/properties/nearest_station/anyOf/0"
},
{
"type": "null"
}
],
"description": "Nearest primary national or regional mainline railway hub (>= 2M annual passengers or Network Rail Category A/B interchange)"
},
"nearest_station": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"distance_km": {
"description": "Straight-line distance in kilometres from postcode coordinates",
"type": "number"
},
"hub_type": {
"description": "Station hierarchy tier based on ORR annual passenger footfall and mainline intercity connectivity",
"enum": [
"national_hub",
"regional_hub",
"commuter_hub",
"local_station"
],
"type": "string"
},
"id": {
"description": "NaPTAN station code (e.g. 9100MNCRVIC, 4900ZZLUWSM1)",
"type": "string"
},
"name": {
"description": "Official station name (e.g. Manchester Victoria, Westminster)",
"type": "string"
},
"station_type": {
"description": "Transit network mode (e.g. National Rail, London Underground, DLR, Metro / Tram)",
"type": "string"
}
},
"required": [
"id",
"name",
"station_type",
"hub_type",
"distance_km"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Nearest National Rail, London Underground, DLR, or light rail / tram station of any classification"
}
},
"required": [
"nearest_station"
],
"type": "object"
}
},
"required": [
"location"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"metric": {
"description": "Target metric to rank postcodes by: \"affluence\" (1-100 score), \"house_price\" (median GBP), \"crime_safety\" (IMD crime decile), \"broadband_speed\" (gigabit availability), \"family_suitability\" (1-100 score), or \"connectivity\" (transit & broadband).",
"enum": [
"affluence",
"house_price",
"crime_safety",
"broadband_speed",
"family_suitability",
"connectivity"
],
"type": "string"
},
"order": {
"default": "desc",
"description": "Sort order: \"desc\" (highest first, default) or \"asc\" (lowest first).",
"enum": [
"desc",
"asc"
],
"type": "string"
},
"postcodes": {
"description": "List of 2 to 10 Great Britain postcodes to screen and rank (e.g. [\"SW1A 1AA\", \"BB7 3BB\", \"M1 1AE\"]). Maximum 10 postcodes.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
}
},
"required": [
"postcodes",
"metric"
],
"type": "object"
},
"name": "screen_postcodes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"leaderboard": {
"items": {
"additionalProperties": false,
"properties": {
"affluence_tier": {
"type": "string"
},
"ai_summary": {
"type": "string"
},
"broadband_speed_tier_mbps": {
"type": [
"number",
"null"
]
},
"connectivity_score_100": {
"type": "number"
},
"crime_safety_decile": {
"type": [
"number",
"null"
]
},
"family_suitability_score_100": {
"type": "number"
},
"median_download_mbps": {
"type": [
"number",
"null"
]
},
"median_house_price_gbp": {
"type": [
"number",
"null"
]
},
"metric_name": {
"type": "string"
},
"metric_value": {
"type": "number"
},
"postcode": {
"type": "string"
},
"rank": {
"type": "number"
}
},
"required": [
"rank",
"postcode",
"metric_name",
"metric_value",
"affluence_tier",
"median_house_price_gbp",
"crime_safety_decile",
"family_suitability_score_100",
"ai_summary"
],
"type": "object"
},
"type": "array"
},
"metric_ranked_by": {
"type": "string"
},
"order": {
"enum": [
"desc",
"asc"
],
"type": "string"
},
"total_screened": {
"type": "number"
}
},
"required": [
"metric_ranked_by",
"order",
"total_screened",
"leaderboard",
"_attribution"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"exclude": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
],
"description": "Optional domain(s) to exclude: \"schools\", \"healthcare\", \"transit\" as a comma-separated string (e.g. \"schools, healthcare\") or an array of strings (e.g. [\"schools\", \"healthcare\"]). Note: exclude only applies when view=\"full\"; ignored if a specific view slice is selected."
},
"outcode": {
"description": "Great Britain outward postal district code to summarize (e.g. SW1A, BB7, M1, EH1, CF10). Covers England, Scotland, and Wales.",
"type": "string"
},
"view": {
"default": "full",
"description": "Optional view slice to return: \"full\" (complete district summary, default), \"brief\" (or \"summary\"/\"ai\", ~80 tokens context summary), \"property\", \"demographics\", \"education\", \"healthcare\", \"transit\", or \"services\".",
"enum": [
"full",
"brief",
"summary",
"ai",
"property",
"demographics",
"education",
"healthcare",
"transit",
"services",
"schools",
"health",
"transport",
"infrastructure"
],
"type": "string"
}
},
"required": [
"outcode"
],
"type": "object"
},
"name": "summarise_outcode",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"_attribution": {
"type": "string"
},
"_billing": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"demo_always_free",
"gateway_partner",
"marketplace_partner",
"mcp_proxy_bypass",
"rapidapi_proxy_bypass",
"mcp_marketplace_license",
"x402_paid_settled"
],
"type": "string"
},
"payer": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"average_affluence_score_100": {
"type": "number"
},
"district_avg_price_per_sqm_gbp": {
"type": "number"
},
"district_context_briefing": {
"type": "string"
},
"district_median_house_price_gbp": {
"type": "number"
},
"dominant_affluence_tier": {
"type": "string"
},
"imd_overall_decile_range": {
"additionalProperties": false,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"outcode": {
"type": "string"
},
"sample_postcodes": {
"items": {
"type": "string"
},
"type": "array"
},
"top_personas": {
"items": {
"type": "string"
},
"type": "array"
},
"total_postcodes": {
"type": "number"
}
},
"required": [
"outcode",
"total_postcodes",
"district_median_house_price_gbp",
"district_avg_price_per_sqm_gbp",
"average_affluence_score_100",
"dominant_affluence_tier",
"imd_overall_decile_range",
"top_personas",
"sample_postcodes",
"district_context_briefing",
"_attribution"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:f78b5169cd7f8370a8e02d393221b0bbcef98cb95b7e9f39ce2c911bc5a00f70 | sha256sum