Skip to main content
29M UK properties, one API call. Get your API key →

Agent MCP / Windsurf

UK property data in Windsurf

Windsurf is Codeium's agentic editor, and its Cascade agent calls MCP tools as it works. Connect Homedata and Cascade can check a property's records mid-task, whether the address came from a spreadsheet, a form or a support ticket.

Copy this to Windsurf

Install the Homedata MCP server (npx -y homedata-mcp) with my API key, YOUR_API_KEY, then find 63 Harvey Lane, Norwich to check it works.

Get your API key Or set it up by hand ↓ 
~/.codeium/windsurf/mcp_config.json
→ {
  "mcpServers": {
    "homedata": {
      "command": "npx",
      "args": ["-y", "homedata-mcp"],
      "env": { "HOMEDATA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Restart Windsurf after saving. The Cascade panel shows the homedata tools alongside built-in ones.

Ask Windsurf

What you can ask once it is connected

Enrich the leads table with property type, bedrooms and floor area.

Flag any property in this list that sits in a flood zone.

Show me how asking prices have moved in LS6 this year.

56 lookups in all, from EPC and flood risk to schools, planning and prices. See everything it can check →

Setup

Connect Homedata to Windsurf

  1. Get your API key. Sign up with your email and copy the key from your dashboard. Top up from £10.
  2. Paste the message above into Windsurf. It installs the server and adds it to Windsurf's config. Prefer to do it yourself? Add the block above to ~/.codeium/windsurf/mcp_config.json with your key in place of YOUR_API_KEY.
  3. Restart and ask. Restart Windsurf after saving. The Cascade panel shows the homedata tools alongside built-in ones.

In practice

How people use Homedata in Windsurf

Pipe UK property data into Cascade: let Windsurf write valuation tooling against live EPC, planning and risk data.

Build a property report feature in your stack while Windsurf queries 29M UK properties in the same conversation.

Questions

Windsurf and Homedata

How do I install the Homedata MCP in Windsurf?

Open ~/.codeium/windsurf/mcp_config.json (create the file if it's missing), paste the homedata block from this page, drop in your API key and relaunch Windsurf. Cascade picks the server up automatically.

Does the MCP work with Windsurf on macOS, Windows and Linux?

Yes: Windsurf is cross-platform and so is homedata-mcp. The path to mcp_config.json is the same on all three platforms under your home directory.

Can I see which tool Cascade is calling?

Yes. Cascade shows the tool name and arguments inline before it runs the call. That's also useful for debugging: if a tool errors, the response is shown in-chat with the error code.

Other agents

UK property data in Claude Desktop → UK property data in Claude Code → UK property data in Cursor → UK property data in Codex CLI → UK property data in Cline → UK property data in Continue.dev → UK property data in Zed →

Give Windsurf a key.

Then ask Windsurf about any home in England and Wales. Pay as you go from £10.

Get your API key About Agent MCP