# Idealista MCP > Idealista MCP lets you manage complex real estate searches across Spain, Italy, and Portugal using natural conversation. You can pinpoint properties for sale or rent by exact GPS coordinates, search commercial spots, track new construction projects, and analyze market data—all without leaving your agent. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** property-search, real-estate-market, geo-spatial-search, housing-data, commercial-property ## Description Need to find a property in Europe but hate clicking through dozens of listing sites? This MCP connects your AI client directly to Idealista's massive real estate database. You talk to your agent like you’re talking to an expert: 'Show me apartments for rent under €1500 near the park.' Your agent handles all the filtering, cross-referencing country regulations, and data pulling across Spain, Italy, and Portugal. It's built for people who need accurate market intelligence. Whether you're looking at a residential sale or scouting commercial offices, this tool makes it possible to query specific areas using GPS coordinates or narrow down results by minimum size and maximum price. Because Vinkius hosts this MCP in its catalog, your agent gets instant access to the full range of Idealista tools—from searching for properties under construction to finding available rental units. It turns vague market questions into actionable lists with real data points. ## Tools ### buscar_inmuebles Searches for properties by providing specific GPS coordinates and a search radius, allowing price and size filtering. ### pisos_venta Finds residential units currently listed for sale within a specified geographic zone or area. ### pisos_alquiler Retrieves the most current listings of houses and apartments that are available to rent in targeted areas. ### obra_nueva Helps you discover details on residential projects, whether they're still under construction or just finished. ### locales_comerciales Searches for available commercial premises like offices and warehouses; defaults to rental listings if no type is specified. ## 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 property listings within a defined radius using precise coordinates, allowing you to filter results immediately by price or size. ### Locate Homes for Sale Query the database specifically for residential properties available for purchase within certain geographic zones. ### Find Rental Units Retrieve current, updated listings of houses and apartments that are currently available to lease in your target area. ### Discover Commercial Spaces Search for commercial opportunities, including offices or warehouses, whether you're looking to rent or buy. ### Track New Developments View details on residential projects that are either under construction or recently completed in a given region. ## Use Cases ### Assessing a Target Neighborhood A client needs to know if an area is viable for investment. Instead of manually checking multiple websites, the agent uses `buscar_inmuebles` with GPS coordinates and runs filters for both minimum size and maximum price to create a comprehensive viability report. ### Finding Client Housing Abroad A corporate relocation agent must find an apartment for a client moving from Madrid to Rome. The agent uses `pisos_alquiler` to target the specific city and filters by budget, retrieving current, updated listings for immediate presentation. ### Planning a New Office Buyout An analyst needs to know what commercial spaces are available. They use `locales_comerciales` and ask the agent to compare both rental availability (default) and outright purchase options, comparing price points across two different zones. ### Monitoring Local Growth A developer is scouting areas for expansion. They use `obra_nueva` to see what high-end residential projects are currently being built in Lisbon, allowing them to time their market entry and pricing strategy. ## Benefits - Precision search using `buscar_inmuebles`: Stop guessing. Pinpoint properties within a 1km radius of exact coordinates, giving you actionable data points immediately. - Full market coverage: You don't have to switch between country sites. This MCP handles residential sales (`pisos_venta`), rentals (`pisos_alquiler`), and commercial needs across Spain, Italy, and Portugal. - Stay ahead of trends with `obra_nueva`: Get details on new developments before they hit the general market. Track construction status and starting prices for major projects. - Comprehensive property types: Need to find an office or warehouse? Use `locales_comerciales` to pull data on commercial premises, not just homes. It covers everything from retail to industrial space. - Efficiency in action: Instead of running five separate searches across different portals, you ask your agent one question and get consolidated results for sales, rentals, and commercial opportunities. ## How It Works The bottom line is, you use natural language to access highly structured, multi-country real estate market data. 1. Subscribe to this MCP and input your Idealista developer API Key and Secret credentials. 2. Tell your agent what you're looking for—for example, 'Find commercial spaces in Barcelona.' 3. Your agent executes the necessary search through the Idealista data and returns a filtered list of properties that match your criteria. ## Frequently Asked Questions **How does Idealista MCP handle geo-spatial searches?** The `buscar_inmuebles` tool lets you find properties using exact GPS coordinates and a specified search radius. This means your query is highly precise, filtering results instantly by price and size within that specific boundary. **Can Idealista MCP find commercial spaces for rent or sale?** Yes, you use `locales_comerciales` to search for both offices and warehouses. If you don't specify if it's a buy or rent, the tool defaults to showing current rental listings. **What is the difference between `pisos_venta` and `pisos_alquiler`?** `pisos_venta` searches only for units listed for purchase. Use `pisos_alquiler` when you are specifically looking for houses or apartments that are available to lease right now. **Does Idealista MCP support multiple countries?** It supports real estate markets across Spain, Italy, and Portugal. You can run a single query asking for general availability across these three nations. **Can I check on new building projects with Idealista MCP?** Absolutely. Use the `obra_nueva` tool to retrieve details on residential projects that are either currently under construction or have recently been finished, keeping you updated on market growth. **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.