How to Use the Idealista (Real Estate) MCP in Windsurf

Q: How do I hook up Idealista (Real Estate) to my Windsurf setup?

Open your /.codeium/windsurf/mcpconfig.json file and add the server details. Windsurf will show the new tools in your MCP panel on your next run.

Q: How does the Idealista (Real Estate) integration handle location-based queries in Windsurf?

The agent uses buscarinmuebles to pass specific GPS coordinates and a search radius directly to the API. It bypasses the web interface entirely to give you raw location data.

Q: Can I filter commercial spaces by lease terms?

The localescomerciales tool defaults to rental listings. If you need to buy, just instruct Cascade to specify purchase parameters in its tool call.

Run multi-step Iberian property searches autonomously in Windsurf using live data from Spain, Italy, and Portugal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Idealista (Real Estate) MCP to Windsurf

Create your Vinkius account to connect Idealista (Real Estate) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Idealista (Real Estate) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain property hunts with Cascade

The `pisos_alquiler` tool pulls live rental data across major Iberian cities. When you ask Cascade to find cheap rentals in Madrid, it doesn't just give you a list. Cascade handles the workflow from start to finish without asking for permission at every turn. You get a clean list of matching properties while your agent does the grinding.

Map commercial spaces using this MCP Server

The `locales_comerciales` tool finds commercial properties in Spain, Italy, and Portugal. It defaults to rental options unless you tell it to buy. You don't need to manually copy-paste coordinates from a map. The agent uses `buscar_inmuebles` to scan specific GPS radii, pulling exact property details directly into your workspace.

Track new developments autonomously

The `obra_nueva` tool searches for residential projects under construction or recently completed. Cascade can cross-reference these new builds with existing resale data from `pisos_venta` to spot pricing discrepancies. This MCP tool lets you build a clean spreadsheet of investment opportunities. You get raw data on construction projects in Lisbon or Milan without clicking through endless browser tabs.

Setup guide

Set up Idealista (Real Estate) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Idealista (Real Estate) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Idealista (Real Estate) payment history." If connected, Cascade will call the Idealista (Real Estate) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "idealista-real-estate-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Idealista. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Idealista (Real Estate) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Idealista (Real Estate) MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server details. Windsurf will show the new tools in your MCP panel on your next run.

Yes, Cascade excels at this. You can tell it to find a property using `pisos_venta` and then immediately check local rental yields by calling `pisos_alquiler` in the same thread.

The agent uses `buscar_inmuebles` to pass specific GPS coordinates and a search radius directly to the API. It bypasses the web interface entirely to give you raw location data.

The `locales_comerciales` tool defaults to rental listings. If you need to buy, just instruct Cascade to specify purchase parameters in its tool call.

Vinkius runs this MCP connection in a secure sandbox. Your GPS coordinates and search parameters pass directly to the target API, meaning your investment strategy stays private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript