Lookup Great Britain Postcode Intelligence Profile
lookup_postcodeRead-onlyIdempotent
Retrieve demographic, property, EPC, broadband, and socio-economic context for a Great Britain unit postcode, returning a full profile or concise brief view.
Instructions
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).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"postcode": "<postcode>"
},
"name": "lookup_postcode"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | 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"). | full |
| exclude | No | 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 | Yes | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| transit | No | ||
| _billing | No | ||
| location | Yes | ||
| _licensing | No | ||
| confidence | No | ||
| match_type | No | ||
| _disclaimer | No | ||
| _attribution | No | ||
| summary_for_ai | No | ||
| landmark_context | No | ||
| resolved_district | No | ||
| requested_postcode | No | ||
| census_demographics | No | ||
| deprivation_deciles | No | ||
| property_and_energy | No | ||
| schools_and_education | No | ||
| digital_infrastructure | No | ||
| healthcare_and_services | No |