Summary
Search Idealista real estate listings (Spain, Italy, Portugal) from any AI assistant. Find apartments and houses for sale or rent, read full listing detail, look up neighborhood data. 4 tools, no auth — reverse-engineered from the Idealista mobile app.
Try asking
Example prompts for Idealista
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
Self-hosted only. Idealista refuses requests from datacenter IP addresses, and AnythingMCP Cloud runs in a datacenter, so this connector is not available on AnythingMCP Cloud. It works on an AnythingMCP instance you run yourself on a computer or server with a regular home or office internet connection.
Idealista + Microsoft Copilot
Search Idealista real estate listings (Spain, Italy, Portugal) from any AI assistant. Find apartments and houses for sale or rent, read full listing detail, look up neighborhood data. 4 tools, no auth — reverse-engineered from the Idealista mobile app.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
(none — public API)
Step 1 — Get credentials
This connector wraps the Idealista mobile app's internal API (app.idealista.it).
Setup: nothing. The mobile API endpoints used here do not require OAuth for read access.
Markets: Idealista operates in Italy, Spain, and Portugal. The locale path segment in URLs (/api/3.5/it/..., /api/3.5/es/..., /api/3.5/pt/...) selects the market. Pass locale as a tool parameter.
What it does NOT do: contact sellers, save searches, post listings. Use this connector to find and read listings; act on them in the Idealista app/site.
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
- Open
http://localhost:3000and register. The first account becomes the admin. - Open the connector store (
http://localhost:3000/connectors/store), pick Idealista, fill in the credentials it asks for (some connectors need none) and install it. - Under MCP Servers, create a server and assign the Idealista connector to it. On the server's page, copy the MCP endpoint (
http://localhost:4000/mcp/<server-id>) and generate a key under API keys.
The quickstart listens on localhost only. For an instance that other people or cloud-based AI clients can reach, clone the repository and run ./setup.sh, which sets up a domain, HTTPS and OAuth (deployment guide).
Step 3 — Add the Idealista connector to Microsoft Copilot
Copilot Studio connects to MCP servers from Microsoft's cloud, so it cannot reach the localhost endpoint of the quickstart. To use Idealista in Microsoft Copilot you need an AnythingMCP instance with a public HTTPS address (see ./setup.sh above) on a connection Idealista accepts. In Copilot Studio, open your agent, go to Tools → Add a tool → New tool → Model Context Protocol, paste the instance's MCP endpoint and choose API key with the header X-API-Key. Then publish the agent to the Microsoft 365 and Microsoft Teams channel.
If a public instance is not an option, use a client that runs on your computer instead: Claude Code, Cursor or Gemini CLI reach localhost directly.
Available tools
| Tool | What it does |
|---|---|
idealista_search | Search Idealista listings with filters |
idealista_get_listing | Full detail of one Idealista listing by ID — full description, all photos, agency, contact, geocoordinate, energy class, characteristics |
idealista_search_locations | Search for Idealista location IDs (cities, neighborhoods, districts) |
idealista_map_search | Search Idealista listings within a geo bounding box (map-driven search) |
FAQ
Why isn't Idealista available on AnythingMCP Cloud? Idealista refuses requests from datacenter IP addresses. AnythingMCP Cloud runs in a datacenter, so every call would fail. An AnythingMCP instance on a home or office connection usually works.
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
Was this guide helpful?