One parcel: owner, units, plot, constraints
parcel_lookupOne land parcel in full: its INSPIRE id, title number and OS id, area and land use, the registered proprietor where a title links, the units standing on it, plot utilisation, and every constraint flag.
Same call over REST
Sourcing parcel/v1/sourcing/parcelNot connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What parcel_lookup answers
Address it by parcel_id, inspire_id, title_number or uprn — whichever handle you have. Use land_assembly instead when you want the neighbours.
CONSTRAINTS ARE THREE-VALUED. in_zone, checked_false and not_checked are three different answers, and a parcel with unchecked flags is UNASSESSED, not unconstrained. Never report an unchecked flag as clear.
Plot coverage is built footprint over parcel area: a ground-plane measure that says nothing about storeys, so it is not a density. The unbuilt ground it implies is an upper bound before any constraint, access or amenity test — not a developable area, and not a capacity.
Restrictive covenants read not_available: the register holds them per title and the title-to-parcel link is partial. UK only.
Inputs
Before you call it
- uprn
- A UPRN is the Unique Property Reference Number every UK address carries. Narrow the address with address_autocomplete, which is free, then address_resolve returns the UPRN for 8 credits. property_summary and address_by_postcode return UPRNs too.
- title_number
- A title number is HM Land Registry's identifier for a registered title. ownership_by_company lists the titles a company holds, and the ownership tier of property_lookup carries the title where the register is matched to the address.
Inputs
Arguments parcel_lookup takes
| Name | Type | Required | Description |
|---|---|---|---|
| parcel_id | string | No | |
| inspire_id | string | No | |
| title_number | string | No | |
| uprn | integer | No |
Usage
How to run parcel_lookup in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool parcel_lookup for <address or area>.
Show the result and the credits charged."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
parcel_lookup costs 1 credit per successful call over MCP and over REST, and the two surfaces share one credit balance.
The price covers licensed records in the response. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Related
Tools used with parcel_lookup
- Adjacent parcels, owners and the combined site2 credits
land_assemblyThe parcels adjacent to one parcel and who owns each — the first question of a site assembly. Returns each neighbour with its area, land use, constraints and registered proprietor, plus a `combined` block: total area in m² and hectares, the number of distinct owners, how many neighbours already share the subject's proprietor (the parcels needing no second negotiation), how many have no linked owner, and every constraint present across the whole assembly.Named in the description - Build cost: index, regional factor, estimateFree
build_costBuild cost for a scheme: the sector's cost index with its 1- and 5-year movement, the regional location factor (`region`: NATIONAL, LONDON, SOUTH_EAST — an error lists what is loaded), the editorial on-cost percentages (prelims, contingency, overheads & profit, professional fees) and, given `gia_m2` and `rate_gbp_m2` (your BCIS or in-house base rate, with `rate_period` in the series' own format, e.g. 2024Q1), an estimate: the rate carried through the index to the latest period, localised, multiplied out, with totals at low / mid / high on-costs. The £/m² benchmark leg says `not_available` until a tender benchmark is loaded — no rate is invented, and nothing here is a modelled number. UK only.Same category - Construction cost index seriesFree
cost_indexConstruction cost index series for a development appraisal's cost side: `basis` is tender (tender price indices), output (output price indices), deflator (the construction deflator) or labour. Optional `sector` (residential, commercial, industrial, infrastructure, all, …), `freq` (monthly | quarterly | annual) and an inclusive period window in the series' own format (2014Q1, 2014M01, 2014). Each series carries its base period and method. UK-wide; regional factors come with the site appraisal. UK only.Same category - Site appraisal dossier5 credits
site_appraisalEverything known about ONE site, assembled and judged — the site dossier.Same category - Rated commercial stock in an authority2 credits
sourcing_commercialRated commercial stock in a local authority, filtered by sector and rateable value — the commercial sourcing lane. Each row carries its rateable value, an income-basis value, the freeholder where a title links, and any auction history.Same category - Live listings enriched against our valuation2 credits
sourcing_live_listingsWhat is on the market RIGHT NOW in these postcode districts, each listing enriched against our own record of the property: asking price against our valuation (`asking_vs_avm_pct`, `discount_to_avm_gbp`), £/m², gross yield on both the asking and valuation bases, unexpired lease years, EPC with its retrofit gap, the designation flags, days listed, the agent, and a plain-language `signals` list.Same category
FAQ
Questions about parcel_lookup
How much does `parcel_lookup` cost?
+
parcel_lookup costs 1 credit per successful call over MCP and over REST, and the two surfaces share one credit balance. The price covers licensed records in the response. A call that fails is not charged.
Do I need to resolve the address first?
+
Yes. parcel_lookup takes a UPRN, not an address. Start with address_autocomplete (free) to narrow the address, then address_resolve (8 credits) to get the UPRN. An assistant with the MarketCode skills installed does both steps on its own.
Which assistants can run `parcel_lookup`?
+
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.
Can I store or republish the results?
+
The response includes records we license. 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 `parcel_lookup` 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 parcel_lookup in your assistant.
30-minute call. We'll connect your assistant live on a real address.