Cómo conectar Idealista a Cursor — via MCP

Solo autoalojado. Idealista rechaza las peticiones que llegan desde direcciones IP de centros de datos, y AnythingMCP Cloud funciona en un centro de datos, así que este conector no está disponible en AnythingMCP Cloud. Funciona en una instancia de AnythingMCP que ejecutes tú mismo en un ordenador o servidor con una conexión a internet normal de casa o de oficina.

Idealista + Cursor

Busca anuncios inmobiliarios de Idealista (España, Italia, Portugal) desde cualquier asistente de IA. Encuentra pisos y casas en venta o alquiler, lee el detalle completo del anuncio, consulta datos de barrios. 4 herramientas, sin autenticación, obtenido mediante ingeniería inversa de la app móvil de Idealista.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

(none — public API)

Paso 1 — Obtener credenciales

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)

Paso 2 — Instalar el 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

1. Abre http://localhost:3000 y regístrate. La primera cuenta pasa a ser la administradora.
2. Abre la tienda de conectores (http://localhost:3000/connectors/store), elige Idealista, introduce las credenciales que pida (algunos conectores no necesitan ninguna) e instálalo.
3. En MCP Servers, crea un servidor y asígnale el conector Idealista. En la página del servidor, copia el MCP endpoint (http://localhost:4000/mcp/<server-id>) y genera una clave en API keys.

El quickstart solo escucha en localhost. Para una instancia a la que puedan llegar otras personas o clientes de IA en la nube, clona el repositorio y ejecuta ./setup.sh, que configura dominio, HTTPS y OAuth (guía de despliegue).

Paso 3 — Añadir el conector en Cursor

Cursor se ejecuta en tu ordenador, así que puede usar el endpoint local. Añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un solo proyecto):

{
  "mcpServers": {
    "idealista": {
      "url": "http://localhost:4000/mcp/<server-id>",
      "headers": { "X-API-Key": "<your-api-key>" }
    }
  }
}

Después comprueba en los ajustes MCP de Cursor que el servidor está activo y que aparecen sus herramientas.

Herramientas disponibles

FAQ

¿Cursor soporta servidores MCP personalizados en el plan free? Sí — MCP está disponible en Hobby, Pro y Business.

¿Por qué Idealista no está disponible en AnythingMCP Cloud? Idealista rechaza las peticiones desde direcciones IP de centros de datos. AnythingMCP Cloud funciona en un centro de datos, así que todas las llamadas fallarían. Con una instancia de AnythingMCP en una conexión de casa o de oficina normalmente funciona.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse