Built-stock profile of an area
area_stock_profileComposition of the built stock in an area: unit counts, HMO share, mixed-use share, median building height and footprint, solar penetration.
Same call over REST
Building stock profile/v1/buildings/stock-profile/{area_id}Not connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What area_stock_profile answers
Medians, not means — one tower would skew an average height enough to make a low-rise district read as mid-rise. Percentages are whole percentages.
area_id is the marts area id from area_resolve.
UK only.
Inputs
Before you call it
- area_id
- The area id is the analytics area identifier, not a name or a GSS code. Call area_resolve with a place name or code ("Hackney", "E5") first; it is free and returns the id with the area's hierarchy. Where it gives both
area_idandanalytics_area_id, passanalytics_area_id.
Example
An example call to area_stock_profile
Use the MarketCode tool area_stock_profile with {"area_id":"c0694b59-04d1-48ab-9a4c-c4f9d7b74f60"} and show me the result.{
"error": "HTTP 502",
"detail": "The origin web server returned an invalid or incomplete response to Cloudflare. This typically indicates the origin is overloaded or misconfigured."
}The call failed with these arguments; the status and message are shown rather than an invented body.
Inputs
Arguments area_stock_profile takes
| Name | Type | Required | Description |
|---|---|---|---|
| area_id | string | Yes |
Usage
How to run area_stock_profile in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool area_stock_profile for <address or area>.
Show the result and the credits charged."
The arguments the assistant will send, for the example on this page:
{"area_id":"c0694b59-04d1-48ab-9a4c-c4f9d7b74f60"}The connect steps for Claude, ChatGPT, Codex, Cursor and Claude Code are on the MCP page.
Price and licence
What it costs, and where the data comes from
area_stock_profile is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- Ordnance Survey
National Geographic Database (buildings, land and sites)
Used under licence from Ordnance Survey · Great Britain
Related
Tools used with area_stock_profile
- Resolve an area nameFree
area_resolveResolve an area name or code ("Hackney", "E5") to its area_id, centroidNamed in the description - Physical form of buildings3 credits
building_physicalPhysical form of the buildings a set of UPRNs sit in: height, volume, footprint area, floor count, construction and roof material, basement, green roof, solar panels, and the residential/commercial unit mix.Same category - Hex-binned density for mapsFree
h3_densityHex-binned stock and transaction density for map layers, at H3 resolution 8.Same category - Mixed-use buildings in an area6 credits
mixed_use_buildingsBuildings holding BOTH residential and commercial units — the conversion and permitted-development cohort.Same category - Plot utilisation of land parcels6 credits
plot_utilisationLand parcels by size and how much of them is built on. Set `max_built_coverage` to 0.2 to find largely undeveloped plots.Same category
Glossary
Terms used here
- Mixed-use building: A building that holds both residential and commercial units; a property of the building's unit mix rather than of any single unit, and the conversion cohort.
- House in multiple occupation (HMO): A property let to three or more tenants from more than one household who share facilities; licensed by the council above five occupants and often restricted by Article 4.
FAQ
Questions about area_stock_profile
How much does `area_stock_profile` cost?
+
area_stock_profile is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Where do I get the area id?
+
From area_resolve, which is free: give it a place name or postcode district and it returns the area id, centroid and hierarchy. area_stock_profile then takes that id.
Which assistants can run `area_stock_profile`?
+
Any MCP client: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Codex and Cursor, each documented on the MCP page. You sign in with your MarketCode account over OAuth; there is no key to paste, and the connection is read-only.
Where does the data come from?
+
Read from Ordnance Survey NGD. Coverage is the UK.
Does `area_stock_profile` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
Try area_stock_profile in your assistant.
30-minute call. We'll connect your assistant live on a real address.