home / mcp / idealista7 mcp server

Idealista7 MCP Server

Access Idealista7 search APIs for Spain, Portugal, and Italy with MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bach-ai-tools-idealista7": {
      "command": "uvx",
      "args": [
        "--from",
        "bach-idealista7",
        "bach_idealista7"
      ],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

This MCP server lets you access Idealista7’s property search API from Spain, Portugal, and Italy. It supports searching houses, flats, garages, commercial properties, offices, and more, all through a lightweight MCP interface you can run locally or remotely.

How to use

You use this MCP server with an MCP client by running one of the supported runtime options. The server requires an API key for RapidAPI authentication, which you supply as an environment variable named API_KEY.

Option 1: run via the uvx launcher (recommended). It automatically installs and runs the server for you.

# Set your RapidAPI key
export API_KEY="your_api_key_here"

# Start using uvx with this MCP
uvx --from bach-idealista7 bach_idealista7

Option 2: run after installation as a local command. Install the package, set your API key, and start the server using its command name.

# Install the package from PyPI
pip install bach-idealista7

# Set your RapidAPI key
export API_KEY="your_api_key_here"

# Run the server (command name matches the package name with underscores)
bach_idealista7

Available tools

list_home_properties

Search for houses and flats with filters for price, area, bedrooms, and amenities; supports sale and rent.

list_storage_rooms

Search storage rooms and spaces.

list_buildings

Search buildings information.

list_lands

Search lands for urban, building, or non-building use.

property_details

Retrieve detailed information for a specific property by ID.

list_garages

Search garage and parking spaces.

get_sublocations

Get sublocations within a given location.

get_microsite_profile

Fetch the agent or microsite profile details.

get_microsite_locations

List locations where the agent has listings.

list_commercial_properties

Search for commercial properties including shops, industrial buildings, and warehouses.

list_offices

Search office listings.

list_rooms

Search rental rooms with co-living related filters.

list_new_homes

Search new homes listings.

get_suggestions

Get location search suggestions (auto-complete).