# Idealista (Real Estate) MCP > Idealista (Real Estate) connects your AI agent to the Idealista developer platform. Find homes, commercial spaces, and new developments across Spain, Italy, and Portugal. Use the agent to run complex, multi-filter searches, from geo-spatial radius checks to specific residential sales or rentals. It handles residential, commercial, and development property types. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** property-search, real-estate-market, geo-spatial-search, housing-data, commercial-property ## Description Idealista connects your AI agent to the Idealista developer platform. You can find homes, commercial spaces, and new developments across Spain, Italy, and Portugal. Your agent handles complex, multi-filter searches, covering residential, commercial, and development property types. **`buscar_inmuebles`** lets you find properties by feeding it specific GPS coordinates and a search radius, and you can narrow results with price and size filters. **`pisos_venta`** lets you search for apartments and houses available for purchase within a specific location ID, and you can set minimum room counts and maximum prices. **`pisos_alquiler`** gives you updated listings for houses or apartments currently available for lease in your target areas. **`locales_comerciales`** searches for commercial real estate, like offices or warehouses, letting you filter by sale or rental status. **`obra_nueva`** helps you discover residential projects that are either under construction or recently finished. ## Tools ### buscar_inmuebles Find properties using GPS coordinates and a search radius, with optional filtering by price and size. ### locales_comerciales Search for commercial properties, defaulting to rentals unless otherwise specified. ### obra_nueva Find residential projects that are either under construction or recently finished. ### pisos_alquiler Get updated listings for houses or apartments available for lease in target areas. ### pisos_venta Search for properties available for purchase in a specific zone. ## Prompt Examples **Prompt:** ``` Search for apartments for rent in Madrid with a maximum price of 1500 euros ``` **Response:** ``` I've found several apartments for rent in Madrid matching your budget. Highlights include a 2-bedroom flat in Chamberí (€1,450), a modern studio in Malasaña (€1,200), and a bright apartment near Retiro (€1,500). Would you like the links to any of these? ``` **Prompt:** ``` Find homes for sale near these coordinates: 40.4167,-3.7033 within 1km ``` **Response:** ``` Searching within 1000m of Central Madrid… I've identified 12 properties for sale. Prices range from €350,000 for a renovatable flat to €1.2M for a luxury penthouse. Would you like me to filter these by minimum size? ``` **Prompt:** ``` What are the new developments available in Lisbon? ``` **Response:** ``` I've retrieved the latest new developments in Lisbon. Current projects include 'Tejo Riverside Residences', 'Chiado Legacy', and 'Belem Garden'. I can provide details on construction status and starting prices for any of these. ``` ## Capabilities ### Search by GPS Coordinates Find properties by giving the agent specific GPS coordinates and a search radius, while also applying price and size filters. ### Find Homes for Sale by Zone Search for apartments and houses available for purchase within a specific location ID, setting minimum room counts and maximum prices. ### Check Current Rental Listings Access updated market data to find houses or apartments currently available for lease in your area. ### Identify Commercial Spaces Search for commercial real estate, like offices or warehouses, filtering by sale or rental status. ### Track New Builds Discover residential projects that are either under construction or recently finished. ## Use Cases ### Finding a new office space near a growing residential area. A developer needs to find office space. They ask their agent to first use `obra_nueva` to identify promising residential developments. Then, they use `locales_comerciales` to check for available offices nearby, ensuring the commercial listing is close to the new residential activity. ### Tracking investment potential in a foreign city. A property investor is scouting a new market. They use `buscar_inmuebles` with GPS coordinates to define a potential zone. Next, they use `pisos_venta` to see what homes are actually listed for sale in that specific area, giving them a quick snapshot of the local market value. ### Managing a client's move across two European countries. A relocation agent needs to find a rental for a client moving from Portugal to Spain. They ask the agent to run `pisos_alquiler` for the target Spanish city and compare it to a previous search done using the server's multi-country support for Portugal. ### Comparing market types in a single city. A real estate analyst wants a full market picture. They ask the agent to check for new developments using `obra_nueva`, then run `pisos_alquiler` to see the current rental inventory, and finally use `locales_comerciales` to gauge commercial vacancy. ## Benefits - Find properties by GPS coordinates using `buscar_inmuebles`. You just give the agent the coordinates and a radius, and it returns filtered results for price and size. - Monitor new construction with the `obra_nueva` tool. You get a list of current residential projects, including details on construction status and starting prices. - Avoid manual searches for rentals. The `pisos_alquiler` tool provides updated listings for apartments or houses available for lease in your target areas. - Target commercial investments using `locales_comerciales`. You can search for offices or warehouses for sale or rent across specific zones. - Search for homes for sale in a specific area with `pisos_venta`. This tool lets you define a location ID and set filters for minimum rooms and maximum price. - Manage multi-country searches easily. The server supports property data across Spain, Italy, and Portugal, so you don't need separate tools for each market. ## How It Works The bottom line is, your agent talks directly to Idealista, giving you real-time, filtered property data without you ever leaving your client. 1. Subscribe to the Idealista server and input your API Key and Secret. 2. Tell your AI agent what you need—for example, 'Find commercial spaces near coordinates X, Y.' 3. The agent runs the appropriate tool, returns the filtered list of properties, and presents the results to you. ## Frequently Asked Questions **How do I use the `buscar_inmuebles` tool to find properties?** The `buscar_inmuebles` tool requires you to provide precise GPS coordinates and a search radius. You can optionally add filters for minimum size or maximum price to narrow down the results. **Can I find commercial spaces using the `locales_comerciales` tool?** Yes. The `locales_comerciales` tool searches for commercial real estate, such as offices or warehouses. It defaults to searching for rentals unless you specify otherwise. **Is the `obra_nueva` tool for properties under construction?** Yes. The `obra_nueva` tool helps you find residential projects that are either under construction or recently completed, keeping you informed about market growth. **Does `pisos_alquiler` cover all countries?** The server supports multiple countries, allowing you to find rental listings for houses or apartments across Spain, Italy, and Portugal. **What is the difference between `pisos_venta` and `buscar_inmuebles`?** `pisos_venta` is used for targeted searches by location ID. `buscar_inmuebles` is used when you have precise GPS coordinates and a radius. **How do I search for rentals using the `pisos_alquiler` tool?** The `pisos_alquiler` tool finds current rental listings. You just need to specify your target area and desired price range for the search. **Is the `obra_nueva` tool suitable for finding new developments in multiple countries?** Yes, the server supports multiple countries. When calling `obra_nueva`, ensure you pass the specific country code (es, it, or pt) to limit the search. **What parameters can I use when calling `pisos_venta`?** You specify the zone or location ID, and optionally, you can filter by size or price range when using `pisos_venta`. **Can I search for properties by specific GPS coordinates?** Yes. Use the `buscar_inmuebles` tool and provide the GPS center (lat,lng) along with a search radius in meters. This allows your agent to find houses, premises, or garages in a precise geographic area. **How do I find residential properties for rent in a specific city?** You can use the `pisos_alquiler` tool by providing the `location_id` for that city or zone. Your agent will return updated market listings, which you can further filter by maximum price. **Does the agent support commercial real estate searches?** Absolutely. Use the `locales_comerciales` tool to find offices, warehouses, and retail spaces for sale or rent in your target areas using specific location identifiers.