idealista MCP server for AI agents
Let Claude, ChatGPT or your own agent read idealista: 1 typed function through one MCP server. No idealista API key needed.
- Site
- idealista.com
- Functions
- 1
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just idealista
An MCP server for idealista alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/idealistaEvery site
One MCP server for idealista and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 1
searchSearches homes for rent or for sale in Spain from plain words or a location path, returning one results page of listings with price, size and…Arguments
Name Type Required querystringYes options.operation"rent" | "sale"Inferred from the query ("rental", "alquiler" → rent), else "sale".No options.locationstringIdealista's own location path, e.g. "barcelona/gracia".No options.bedroomsnumberExact bedroom count; also read from the query ("2 bedroom").No options.maxPricenumberEuros.No options.pagenumberNo Returns
IdealistaSearchResultinterface IdealistaListing { id: string; url: string; title: string; /** euros, per month for a rental */ price: number | null; priceText: string; bedrooms: number | null; sizeM2: number | null; details: string[]; description: string; image: string | null; } interface IdealistaSearchResult { operation: "rent" | "sale"; url: string; page: number; /** the site's own match count, before the bedroom/price filter */ total: number | null; bedrooms: number | null; offers: IdealistaListing[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/idealista/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.idealista.search("2 bedroom rental Gracia Barcelona");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.idealista.search("2 bedroom rental Gracia Barcelona"))curl -X POST https://api.bowmark.ai/v1/sites/idealista/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"2 bedroom rental Gracia Barcelona"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.idealista.search("2 bedroom rental Gracia Barcelona");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/idealista/<function> - OpenAPI
/v1/sites/idealista/openapi.json