MCP · Windsurf
UK property data in Windsurf
A serverUrl in mcp_config.json, used by Cascade. Sign-in is prompted. Once connected, Windsurf 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 using Windsurf who want Cascade to pull property facts into the code it writes, and to check an address or a price without leaving the editor.
https://mcp.marketcode.ai/mcpSteps
How to connect Windsurf
- 01
Add the server
Open Windsurf Settings, then Cascade, then MCP servers, and choose Add custom server. Or edit ~/.codeium/windsurf/mcp_config.json directly.
~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "marketcode": { "serverUrl": "https://mcp.marketcode.ai/mcp" } } } - 02
Sign in
Windsurf opens a browser window for the server's sign-in. Sign in with your MarketCode account and approve the read-only property scope.
- 03
Use it in Cascade
Refresh the MCP list if the tools do not appear, then ask Cascade a property question. It picks the tools from their descriptions.
The same steps sit beside the other clients on the MCP page.
Prompts
Things to ask Windsurf once it is connected
- “Give me the house price index and the live listing stock for Manchester, and say whether the index is local or national.”
- “Resolve this address, then fetch its comparables and explain the trust score.”
- “List the planning designations at 12 Lordship Lane, SE22 8HN and flag anything that would block a loft extension.”
Use serverUrl, not command: the server is remote, there is nothing to install.
Windsurf caps the number of MCP tools it loads at once; if you run many servers, MarketCode's tools may need room made for them.
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 Windsurf
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.
Where is the config file?
+
In your home directory at ~/.codeium/windsurf/mcp_config.json. Windsurf writes it when you add a server through settings; editing it by hand is the same thing.
Also
Other clients
We'll connect Windsurf with you, on a real address.
Thirty minutes. You leave with the connection made and a question answered.