# MarketCode MCP server

> Query UK property data by address or UPRN: ownership, leases, sales, EPCs, valuations, risk and market analytics with provenance.

- Listing: https://mcp.tc/i/marketcode
- Connect: use the server's own URL `https://mcp.marketcode.ai/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Data & Analytics](https://mcp.tc/c/analytics)
- Vendor: MarketCode
- Homepage: <https://marketcode.ai/data/mcp>
- Docs: <https://marketcode.ai/data/api>

## About

MarketCode is a UK property data warehouse covering addresses and UPRNs, ownership and leases, sold prices, valuations, flood and other risk flags, listings and area market analytics. Tools resolve addresses to UPRNs, return property records and comparables, and rank or chart areas on price, yield, volume and index series, with the source behind each figure.

It runs as a hosted streamable HTTP endpoint at https://mcp.marketcode.ai/mcp. The endpoint accepts OAuth tokens and some tools are charged in credits. Access needs MarketCode credentials.

## What it can do

- Autocomplete and resolve UK addresses to UPRNs
- Get full property records, summaries and sold-price history
- Check registered leases and flood or designation risk
- Get automated valuations with comparable sales and rents
- Rank areas on price, yield and transaction volume
- Read house price index series and forecasts
- Trace corporate ownership networks

## Tools (106)

- `entity_search_capabilities`: List searchable entity families, criteria, coverage and query limits. (read-only)
- `lookup_entities`: Find public records by title, address text, postcode or UUID. (read-only)
- `ask_question`: Route a place or figure question through the MarketCode Ask router. (read-only)
- `search_entities`: Search assets, completed sales, planning and market profiles. (read-only)
- `search_summary`: Counts and statistics over EXACTLY what \`search\_entities\` would match: how many records, grouped by a field, with min, median, mean and max of up to three numeric fields. (read-only)
- `market_profile`: Market profile for an area and bedroom cohort. (read-only)
- `entity_relationships`: Recorded entity relationships from the derived graph. (read-only)
- `actor_network`: Investigate corporate ownership, title and agency relationships. (read-only)
- `actor_path`: Find a recorded path between two corporate records. (read-only)
- `address_autocomplete`: Ranked address candidates for a partial address or postcode. (read-only)
- `address_resolve`: Resolve free-text address to a canonical UPRN. (read-only)
- `address_by_uprn`: Look up an address by UPRN. (read-only)
- `address_by_postcode`: List all addresses at a UK postcode. (read-only)
- `property_lookup`: Full property record for a UPRN, grouped into tiers. (read-only)
- `property_reconcile`: Cross-source property facts with provenance. (read-only)
- `market_facts`: Price, price per sqm and turnover for one area, class and period. (read-only)
- `market_ranking`: Rank areas against each other on a market metric. (read-only)
- `market_volume_series`: Monthly transaction volume for a district, area or county. (read-only)
- `market_index_series`: House price index series for a district or local authority. (read-only)
- `market_yields`: Monthly gross rental yield on asking and other bases. (read-only)
- `market_forecast`: House price index forecast with bands. (read-only)
- `supply_demand`: Live stock and monthly listing flow for an area. (read-only)
- `time_adjustment`: Index factor between a past sale date and the latest month. (read-only)
- `commercial_index_series`: Quarterly repeat-sales capital index for UK commercial property. (read-only)
- `commercial_rent_index_series`: Commercial rent index from VOA rating lists. (read-only)
- `market_volume_ranking`: Rank postcode districts by volume or median price. (read-only)
- `transactions_by_uprn`: HMLR Price Paid records for a UPRN. (read-only)
- `property_summary`: One-call summary of a property and its building. (read-only)
- `property_history`: Sold-price history with per-sale detail. (read-only)
- `property_comps`: Comparable sales in the same building or block. (read-only)
- `property_flood_risk`: Environment Agency surface-water flood risk for a property. (read-only)
- `valuation_estimate`: Automated value point estimate with range. (read-only)
- `valuation_full`: Full valuation with monthly back-series. (read-only)
- `property_lease`: Registered leases: term, unexpired years and flags. (read-only)
- `property_lease_batch`: Registered leases for up to 100 properties. (read-only)
- `property_risk_report`: Designation and hazard flags, each with source. (read-only)
- `property_risk_report_batch`: Risk reports for up to 100 properties. (read-only)
- `comps_adjustments`: Same-building comparables with time adjustments. (read-only)
- `valuation_comparables`: Scored comparable sales near the property. (read-only)
- `valuation_rent_comparables`: Comparable asking lets and the rent they indicate. (read-only)
- `subject_transaction_anchor`: The property's last sale carried to today by the index. (read-only)
- `valuation_accuracy`: How accurate our valuations have been, measured the only way that cannot leak: each month, every registered sale the model had ALREADY valued is compared with the price actually paid — MdAPE (median absolute percentage… (read-only)
- `planning_designations`: Every planning designation affecting a location, in one call: conservation area, listed building, green belt, AONB, national park, flood zone, Article 4, brownfield, ancient woodland, heritage at risk, TPO, AQMA and… (read-only)
- `planning_check`: The planning designation checks you choose, for one location, in one call. (read-only)
- `planning_applications`: Planning applications near a location, from the register we hold: the reference, proposal, type, decision and dates of each, nearest first. (read-only)
- `constraints_for_geometry`: Every planning and environmental designation on a red line, a piece of land or a point, from the current published layers: green belt, National Landscapes, national parks, SSSI, SAC, SPA, Ramsar, ancient woodland… (read-only)
- `strategic_sites`: Local plan site allocations, broad locations, land availability assessment (SHLAA/HELAA/LAA) sites and call-for-sites submissions, in an authority or near a site (\`radius\_m\`, up to 10 km). (read-only)
- `policy_context`: The planning policy picture for a site: the adopted and emerging local plan with stage and dates, the local plan policies whose areas cover the site (reference, name, theme, a text extract, the share of the site), the… (read-only)
- `lpa_profile`: A planning authority at a glance: its local plans with stage, dates, period and housing requirement; the plan timetable; the Housing Delivery Test result and consequence and other published facts (five-year supply… (read-only)
- `planning_appeals`: Planning Inspectorate appeal decisions in an authority: case reference, the council's application reference, appeal type and procedure, site address, development type, decision and date. (read-only)
- `grid_capacity`: Primary substations near a site, nearest first, with each network operator's published demand and generation headroom, voltage and distance; renewable energy projects (REPD) nearby; and which operators' figures we hold. (read-only)
- `site_access`: The nearest bus stops, rail stations, metro or tram stops, ferry terminals and open schools to a site, straight-line in metres, with names and NaPTAN or school references. (read-only)
- `area_resolve`: Resolve an area name or code ("Hackney", "E5") to its area\_id, centroid and full hierarchy as breadcrumbs. (read-only)
- `area_reverse_geocode`: The area of a given type containing a coordinate. (read-only)
- `ownership_by_title`: Registered proprietor(s) for an HMLR title number. (read-only)
- `ownership_by_company`: Titles held by a company, by Companies House number. (read-only)
- `auction_lots`: Individual UK auction lots: the guide price a lot was marketed at, whether it sold, the HAMMER PRICE where the auctioneer published one, and the net yield where quoted. (read-only)
- `auction_stats`: Quarterly UK auction statistics by postcode district: lots offered, lots sold, the sale rate, and average guide, achieved and net yield. (read-only)
- `distressed_assets`: Properties that keep going to auction and NEVER SELL — the distress screen. (read-only)
- `cost_index`: Construction 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. (read-only)
- `site_appraisal`: Everything known about ONE site, assembled and judged — the site dossier. (read-only)
- `mortgage_rates`: Average UK mortgage rates from the Bank of England: 2-year fixed, 3-year fixed at 75% LTV, and the standard variable rate. (read-only)
- `lha_rate`: Local Housing Allowance for a postcode and bedroom category — the ceiling on housing benefit, and therefore the effective rent floor for a benefit-funded tenancy. (read-only)
- `council_tax_band`: VOA council tax band for a property, from the official list. (read-only)
- `auction_discount`: How far below our valuation UK auction actually clears — the one auction number nobody else can produce. (read-only)
- `auction_comps`: Auction comparables on ACHIEVED prices, each against our valuation. (read-only)
- `epc_certificates`: Recent Energy Performance Certificates for a property, newest first: up to five mart certificates and up to five raw certificates. (read-only)
- `energy_profile`: Energy composition of an area: EPC band mix, mains gas / electric / oil split, heat-pump penetration. (read-only)
- `retrofit_candidates`: Properties in an area with the most improvement headroom, ranked by potential efficiency. (read-only)
- `solar_potential`: Roof characteristics for solar screening: footprint area, roof shape and material, building height, and whether panels are already present. (read-only)
- `agent_activity`: Which estate agents actually transact in an area, ranked by listing count. (read-only)
- `listing_history`: Every marketing snapshot for a property: asking price over time, price reductions, days listed, status changes, agent, image count and whether it had a floor plan. (read-only)
- `equity_estimate`: Current estimated value against the last recorded sale: gain in pounds and percent, and how long it has been held. (read-only)
- `long_held_high_equity`: Long-held properties in an area carrying a large paper gain — the classic off-market cohort, ordered by gain rather than by value. (read-only)
- `owner_profile`: What the Land Registry shows for one proprietor: titles held, company status, country of incorporation, directors and PSCs where known. (read-only)
- `building_physical`: Physical 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. (read-only)
- `area_stock_profile`: Composition of the built stock in an area: unit counts, HMO share, mixed-use share, median building height and footprint, solar penetration. (read-only)
- `mixed_use_buildings`: Buildings holding BOTH residential and commercial units — the conversion and permitted-development cohort. (read-only)
- `plot_utilisation`: Land parcels by size and how much of them is built on. (read-only)
- `h3_density`: Hex-binned stock and transaction density for map layers, at H3 resolution 8. (read-only)
- `sourcing_search`: Find land parcels, property units or buildings matching search criteria — the sourcing tool. (read-only)
- `sourcing_owners`: Resolve registered owners for parcels returned by \`sourcing\_search\`. (read-only)
- `query_semantic`: Run a governed query against the semantic layer: choose an entity, then the metrics, dimensions and filters you want. (read-only)
- `asking_price_index_series`: Hedonic ASKING-PRICE index for one postcode district, local authority or Great Britain, from portal listings (Rightmove ~95%), 2022M01 = 100, with 80% bands and posterior standard errors, smoothed toward the parent… (read-only)
- `asking_rent_index_series`: Hedonic ASKING-RENT index for one postcode district, local authority or Great Britain, from portal lettings, 2022M01 = 100, with bands and SEs. (read-only)
- `listing_market_series`: Monthly supply-side statistics from portal listings for one area, channel and bedroom band: listings added and reduced, reduction share (the market-temperature signal), asking price or rent median and quartiles, £/m²… (read-only)
- `listing_stock_series`: Live listings on the market by day for one area, channel and bedroom band — the stock-on-market series, with the median age of the dated live stock, median asking price or rent, and the new-build count. (read-only)
- `property_planning_history`: Planning history AT this property: applications linked to the unit or its building — each with decision, dates, appeal, CIL liability, development type and \`match\_level\` (\`unit\`, \`building\`, or \`nearby\` within 25 m… (read-only)
- `property_planning_history_batch`: \`property\_planning\_history\` for up to 100 properties in one call, per-item outcomes (ok \| no\_applications \| not\_covered \| not\_found \| error) in input order. (read-only)
- `commercial_property`: The commercial property report, by UPRN or by VOA UARN: the hereditament as the 2026 rating list describes it (rateable value, sector, description), the sector's rent index across the 2010/2017/2023/2026 lists and its… (read-only)
- `build_cost`: Build 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… (read-only)
- `data_coverage`: The 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… (read-only)
- `sourcing_strategies`: The nine sourcing strategies as data — read this BEFORE running \`sourcing\_search\` in strategy mode. (read-only)
- `sourcing_live_listings`: What 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… (read-only)
- `sourcing_offmarket_owners`: Who owns the stock in an area, ranked as an approach list: units held here, total value and equity, average and longest years held, how many of their units are on a short lease or already on the market, company status… (read-only)
- `land_assembly`: The parcels adjacent to one parcel and who owns each — the first question of a site assembly. (read-only)
- `planning_precedents`: What happened to applications like this one nearby — the planning precedent record. (read-only)
- `commercial_market`: The commercial market for a sector and a place: the repeat-sales CAPITAL index, the VOA rating-list RENT index, and the rated stock standing in the authority with its hereditament count, total and median rateable value. (read-only)
- `sourcing_commercial`: Rated commercial stock in a local authority, filtered by sector and rateable value — the commercial sourcing lane. (read-only)
- `parcel_lookup`: One 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. (read-only)
- … and 6 more on the listing page.

## Example prompts

- "Find the UPRN for 10 Example Street, London and summarise the property."
- "Show the sold-price history and lease details for this UPRN."
- "Rank postcode districts in Greater London by median price last year."
- "What is the gross rental yield trend for 2-bed flats in SW11?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http marketcode https://mcp.marketcode.ai/mcp
```

2. Start Claude Code, type `/mcp`, pick **marketcode** and choose **Authenticate**. A browser window opens for the MarketCode sign-in.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **MarketCode** and paste this URL:

```url
https://mcp.marketcode.ai/mcp
```

3. Click **Add**, then **Connect**, and sign in when MarketCode asks.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=MarketCode&connectorUrl=https%3A%2F%2Fmcp.marketcode.ai%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp.marketcode.ai/mcp` and click **Add**.

3. Click **Connect** and sign in when MarketCode asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://mcp.marketcode.ai/mcp` as the server URL, then for authentication choose **OAuth**. ChatGPT sends you to MarketCode to sign in.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=marketcode&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXJrZXRjb2RlLmFpL21jcCJ9>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "marketcode": {
      "url": "https://mcp.marketcode.ai/mcp"
    }
  }
}
```

Cursor shows **Needs authentication** next to the server. Click the button beside it to sign in.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=marketcode&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.marketcode.ai%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"marketcode","type":"http","url":"https://mcp.marketcode.ai/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "marketcode": {
      "type": "http",
      "url": "https://mcp.marketcode.ai/mcp"
    }
  }
}
```

VS Code asks you to sign in the first time the server starts.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "marketcode": {
      "serverUrl": "https://mcp.marketcode.ai/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add marketcode --url https://mcp.marketcode.ai/mcp
codex mcp login marketcode
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.marketcode]
url = "https://mcp.marketcode.ai/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http marketcode https://mcp.marketcode.ai/mcp
```

Then, inside Gemini CLI, run `/mcp auth marketcode` to sign in.

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "marketcode": {
      "type": "http",
      "url": "https://mcp.marketcode.ai/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.marketcode.ai/mcp`.

## Recent changes

- 2026-11-04 02:48 UTC: 7 tools added and 1 tool changed. Source: automatic check. Added: constraints\_for\_geometry, grid\_capacity, lpa\_profile, planning\_appeals, policy\_context, site\_access, strategic\_sites. Changed: planning\_applications.
- 2026-10-29 14:43 UTC: 1 tool changed. Source: automatic check. Changed: query\_semantic.
- 2026-10-28 17:47 UTC: 1 tool added, 1 tool removed and 1 tool changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Added: search\_summary. Removed: query\_sql. Changed: query\_semantic.
- 2026-10-27 17:38 UTC: Tracking started: 99 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/marketcode#history (Atom feed: https://mcp.tc/i/marketcode/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.1.0
- MCP protocol version: 2025-11-25
- Last checked: 2026-11-18 (reachable, asks for credentials)
- Listed: 2026-10-27
- Updated: 2026-11-04

---
Source: https://mcp.tc/i/marketcode (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
