MCP · Cursor
UK property data in Cursor
A URL in .cursor/mcp.json. No headers. Once connected, Cursor can resolve any UK address, value it, read its sale and listing history, check its planning constraints and name its registered owner, and read the published indices for any area. 94 tools, 51 of them free, one read-only sign-in.
Developers who want the property data available inside the editor while they build against the API, and want the agent to check a UPRN or a price without leaving the file.
https://mcp.marketcode.ai/mcpSteps
How to connect Cursor
- 01
Add the server to mcp.json
Create or edit .cursor/mcp.json in your project (or the global one in your home directory) with the server URL and no headers.
.cursor/mcp.json{ "mcpServers": { "marketcode": { "url": "https://mcp.marketcode.ai/mcp" } } } - 02
Log in
Open Cursor Settings, MCP, find MarketCode and choose Login. Approve the read-only property scope in the browser window that opens.
- 03
Use it in agent mode
In a chat with agent mode on, ask a property question; Cursor picks the tools from their descriptions.
The same steps sit beside the other clients on the MCP page.
Prompts
Things to ask Cursor once it is connected
- “Resolve this address to a UPRN and fetch its sale history and council tax band.”
- “Write a function that calls the REST twin of valuation_full; first call the MCP tool so we know the response shape.”
- “List the MarketCode tools that take an area_id and what area_resolve returns for "Hackney".”
Do not put an API key in the config's headers. The server is built for OAuth and a key in a shared project file leaks.
The tool descriptions are long on purpose: they tell the agent which argument to pass and what to read before quoting a number.
Tools
Tools to try first
Resolve an address to a UPRN
address_resolve()Resolve free-text address to canonical record (UPRN for UK).
Property summary
property_summary()One-call summary of a property: what it is, what building it belongs to,
Full valuation with back-series
valuation_full()Full valuation block for a property: the value and its range, a monthly
House price index series
market_index_series()The published house-price INDEX for one postcode district or local authority: the level per month (base period = 100), the forecast tail flagged, and provenance saying how the index was built.
Planning designations at a location
planning_designations()Every planning designation affecting a location, in one call: conservation
Registered proprietors of a title
ownership_by_title()Registered proprietor(s) for an HMLR title number.
FAQ
Questions about MarketCode in Cursor
Do I need an API key?
+
No. MCP clients sign in with your MarketCode account over OAuth and receive a read-only token. API keys are for the REST API; pasting one into an MCP client does nothing useful and puts a secret where it does not belong.
What does it cost?
+
The catalogue shows which tools are currently free. Priced tools charge fixed credits per successful call, the same as over REST, and a new account starts with free credits. Every tool page and the pricing page show the price; a failed call is not charged.
What can a connected assistant do to my account?
+
Read property data and spend credits at the catalogue price. The scope is read-only property data; it cannot see or change your keys, billing or account, and you can revoke the connection in the Hub at any time.
Project or global config?
+
Either. A project file lets teammates get the server when they open the repo; each person still signs in with their own MarketCode account, so credits are per person.
Also
Other clients
We'll connect Cursor with you, on a real address.
Thirty minutes. You leave with the connection made and a question answered.