List the addresses at a postcode
address_by_postcodeReturn all addresses at a UK postcode.
Same call over REST
Address by postcode/v1/address/postcode/{postcode}Not connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Inputs
Before you call it
- postcode
- The postcode must be a full UK postcode ("SE22 8HN"), not a district. Where a tool works at district grain it truncates the postcode itself.
Example
An example call to address_by_postcode
Use the MarketCode tool address_by_postcode with {"postcode":"SE22 8HN"} and show me the result.{
"postcode": "<string>",
"country": "<string>",
"data": {
"data": {
"matches": [
{
"id": "<string>",
"uprn": 0,
"similarity_distance": null,
"match_score": 0,
"distance": null,
"address": "<string>",
"address_highlight": null,
"confidence_score": 0,
"exact_match": false,
"is_residential": false,
"last_verified": "<string>",
"source": "<string>",
"session": null,
"elements": "<string>"
}
],
"total_matches": 0,
"search_time_ms": 0
}
},
"credits_charged": 0
}Shape only. This call returns licensed records, so the keys are real and every value is a placeholder of its type.
Inputs
Arguments address_by_postcode takes
| Name | Type | Required | Description |
|---|---|---|---|
| postcode | string | Yes |
Response
What comes back
| Field | Type |
|---|---|
| postcode | string |
| country | string |
| data | object |
| data.data | object |
| data.data.matches | array |
| data.data.matches[].id | string |
| data.data.matches[].uprn | integer |
| data.data.matches[].similarity_distance | null |
| data.data.matches[].match_score | integer |
| data.data.matches[].distance | null |
| data.data.matches[].address | string |
| data.data.matches[].address_highlight | null |
| data.data.matches[].confidence_score | integer |
| data.data.matches[].exact_match | boolean |
| data.data.matches[].is_residential | boolean |
| data.data.matches[].last_verified | string |
| data.data.matches[].source | string |
| data.data.matches[].session | null |
| data.data.matches[].elements | string |
| data.data.total_matches | integer |
| data.data.search_time_ms | number |
| credits_charged | integer |
Fields observed in the example response above; a field the example did not exercise is not listed.
Usage
How to run address_by_postcode in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool address_by_postcode for <address or area>.
Show the result and the credits charged."
The arguments the assistant will send, for the example on this page:
{"postcode":"SE22 8HN"}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
address_by_postcode costs 10 credits per successful call over MCP and over REST, and the two surfaces share one credit balance.
The price covers licensed records in the response, from Ordnance Survey. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- Ordnance Survey
AddressBase
Used under licence from Ordnance Survey · Great Britain
Related
Tools used with address_by_postcode
- Autocomplete a UK addressFree
address_autocompleteFree address autocomplete. Returns ranked candidates for a partial addressSame category - Resolve an address to a UPRN8 credits
address_resolveResolve free-text address to canonical record (UPRN for UK).Same category - Look up an address by UPRN8 credits
address_by_uprnLook up an address by UPRN (UK only).Same category
FAQ
Questions about address_by_postcode
How much does `address_by_postcode` cost?
+
address_by_postcode costs 10 credits per successful call over MCP and over REST, and the two surfaces share one credit balance. The price covers licensed records in the response, from Ordnance Survey. A call that fails is not charged.
Which assistants can run `address_by_postcode`?
+
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 AddressBase.
Can I store or republish the results?
+
The response includes records we license from Ordnance Survey. Use them in your own analysis, reports and products; bulk redistribution of the raw records or building a competing dataset from them is not covered. Ask us if you need a redistribution licence.
Does `address_by_postcode` 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 address_by_postcode in your assistant.
30-minute call. We'll connect your assistant live on a real address.