Area containing a coordinate
area_reverse_geocodeThe area of a given type containing a coordinate. `type_id` is an area
Same call over REST
Area reverse geocode/v1/areas/reverse-geocodeNot connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Inputs
Before you call it
- type_id
- The area type id names one geography layer (district, ward, local authority). A point sits inside exactly one area per layer, so the id is required; the hierarchy area_resolve returns lists the layers and their ids.
- lat
- Coordinates are WGS84 latitude and longitude, the order a map gives them. A postcode is accepted wherever
locationis, and is usually the easier input.
Example
An example call to area_reverse_geocode
Use the MarketCode tool area_reverse_geocode with {"lat":51.4613,"lng":-0.0106,"type_id":"3977a3cf-ccdb-4be4-90ec-ad43cacb0b42"} and show me the result.{
"country": "UK",
"query": {
"lat": 51.4613,
"lng": -0.0106,
"type_id": "3977a3cf-ccdb-4be4-90ec-ad43cacb0b42"
},
"data": {
"id": "e7eb27fb-677c-4b58-b9ba-414769855966",
"name": "Lewisham",
"area_type_id": "3977a3cf-ccdb-4be4-90ec-ad43cacb0b42",
"area_type_name": null,
"analytics_area_id": null
},
"credits_charged": 0
}A real response, captured from production and trimmed: arrays to three items, long strings shortened, volatile keys dropped.
Inputs
Arguments area_reverse_geocode takes
| Name | Type | Required | Description |
|---|---|---|---|
| lat | number | Yes | |
| lng | number | Yes | |
| type_id | string | Yes |
Response
What comes back
| Field | Type | Example |
|---|---|---|
| country | string | UK |
| query | object | |
| query.lat | number | 51.4613 |
| query.lng | number | -0.0106 |
| query.type_id | string | 3977a3cf-ccdb-4be4-90ec-ad43cacb0b42 |
| data | object | |
| data.id | string | e7eb27fb-677c-4b58-b9ba-414769855966 |
| data.name | string | Lewisham |
| data.area_type_id | string | 3977a3cf-ccdb-4be4-90ec-ad43cacb0b42 |
| data.area_type_name | null | |
| data.analytics_area_id | null | |
| credits_charged | integer | 0 |
Fields observed in the example response above; a field the example did not exercise is not listed.
Usage
How to run area_reverse_geocode in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool area_reverse_geocode for <address or area>.
Show the result and the credits charged."
The arguments the assistant will send, for the example on this page:
{"lat":51.4613,"lng":-0.0106,"type_id":"3977a3cf-ccdb-4be4-90ec-ad43cacb0b42"}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_reverse_geocode 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.
Related
Tools used with area_reverse_geocode
- One composed document for an area5 credits
area_reportThe market for one area, as one document: sourcing readiness per strategy from the coverage register, the commercial capital and rent indices with rated stock, the planning decision record for the authority, and the live listing stock.Same category - Data coverage register for a local authorityFree
data_coverageThe data-coverage register for a local authority — read it before the data: per-field non-null and source shares over every unit in the authority (floor area, bedrooms, year built, EPC, last sale, tenure…), which designation flags were checked and how fully, how many units carry a registered lease or a hereditament, whether official planning data covers the authority and how deep it goes (applications, link shares, latest decision), and how much of the live listing stock the sweep has dated. `area` is a GSS code (E09000032), a local authority name (Wandsworth) or a warehouse area id. State the coverage before quoting a share from a thin field. UK only.Same category - Resolve an area nameFree
area_resolveResolve an area name or code ("Hackney", "E5") to its area_id, centroidSame category
FAQ
Questions about area_reverse_geocode
How much does `area_reverse_geocode` cost?
+
area_reverse_geocode 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.
Which assistants can run `area_reverse_geocode`?
+
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?
+
The answer is computed by MarketCode. Coverage is the UK.
Does `area_reverse_geocode` 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_reverse_geocode in your assistant.
30-minute call. We'll connect your assistant live on a real address.