Cenogram - Polish Real Estate Transactions (RCN)

Servidor MCP Cenogram

Datos de transacciones inmobiliarias y parcelas de Polonia para IA

Servidor MCP para datos inmobiliarios polacos. Accede a más de 8 millones de transacciones inmobiliarias del registro nacional de Precios y Valores (Rejestr Cen Nieruchomosci, RCN): precios de escrituras notariales, no de anuncios, directamente desde Claude, Cursor, ChatGPT, Grok o cualquier asistente de IA compatible con MCP. Además de los precios de transacción, el servidor resuelve parcelas catastrales y añade contexto por parcela: zonificación, riesgo de inundación y deslizamiento, registro de patrimonio, permisos de construcción y actividad de obra, acceso a transporte público, clasificación agrícola del suelo y uso del suelo circundante.

Fuente de datos: registro nacional polaco RCN (Rejestr Cen Nieruchomosci) | Plataforma: cenogram.pl

Obtén tu clave de API

1. Ve a cenogram.pl/api
2. Introduce tu correo electrónico
3. Recibirás tu clave de API cngrm_... por correo electrónico

Gestiona tus claves en cenogram.pl/ustawienia.

Instalación

Elige tu cliente. Todas las opciones a continuación utilizan el servidor alojado: no se necesita instalación local (excepto npx/stdio).

claude mcp add cenogram https://mcp.cenogram.pl/mcp \
  -t http -H "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "cenogram": {
    "type": "http",
    "url": "https://mcp.cenogram.pl/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Configuración

También puedes usar el indicador de línea de comandos --http en lugar de MCP_TRANSPORT=http.

Consejos

• Selección de modelo: Para obtener los mejores resultados, usa Claude Opus 4.7. Realiza más llamadas a herramientas secuenciales y produce análisis más ricos. Puedes cambiar el modelo en el menú desplegable en la parte inferior de la ventana de chat.

Ejemplos de Prompts

Polaco:

• "Jaka jest mediana cen mieszkan w Krakowie w 2025?"
• "Pokaz transakcje z ulicy Pulawskiej 15 na Mokotowie"
• "Znajdz transakcje na dzialce 126104_9.0015.201"
• "Sprawdz plan miejscowy i ryzyko powodziowe dla dzialki 126104_9.0015.201"
• "Znajdz transakcje gruntow w promieniu 5km od centrum Wroclawia powyzej 500 000 PLN"
• "Porownaj ceny mieszkan na Mokotowie i Woli"
• "Pokaz rozklad cen nieruchomosci w Polsce"

Inglés:

• "What's the median apartment price in Krakow in 2025?"
• "Show transactions at Pulawska 15 in Mokotow"
• "Find all transactions on parcel 126104_9.0015.201 and then search nearby"
• "Check the zoning and flood risk for parcel 126104_9.0015.201"
• "Find land transactions within 5km of Wroclaw center above 500,000 PLN"
• "Compare apartment prices in Mokotow and Wola districts"
• "Show the price distribution of real estate in Poland"

Herramientas

Nomenclatura de ubicaciones

• La mayoría de las ciudades: usa directamente el nombre de la ciudad (por ejemplo, "Gdansk", "Lublin")
• Varsovia: "Warszawa" cubre los 18 distritos a la vez; nombra uno ("Mokotow", "Srodmiescie", "Wola") para acotar
• Cracovia y Lodz funcionan igual: el nombre de la ciudad cubre todos los subdistritos, o nombra uno ("Krakow-Podgorze")
• Los nombres de barrios no son unidades administrativas: busca por radio o polígono en su lugar
• Usa list_locations para encontrar nombres válidos

Tipos de propiedad

Flujos de trabajo

Los resultados incluyen IDs de parcela y coordenadas GPS, lo que permite investigación en varios pasos:

1. Search by address    -> search_transactions(location="Mokotow", street="Pulawska", buildingNumber="15")
2. Note parcel_id and coordinates from results
3. Search nearby        -> search_by_area(lat=52.19, lng=21.01, radiusKm=2, propertyType="unit")
4. Compare prices       -> get_price_statistics(location="Mokotow")

Esto imita cómo un tasador de propiedades encuentra transacciones comparables para informes de valoración.

Datos

• Más de 8 millones de transacciones de toda Polonia (380 condados)
• Rango de fechas: 2003 - presente
• Fuente: registro nacional polaco RCN (Rejestr Cen Nieruchomosci)
• Actualización: actualizaciones periódicas de RCN
• Contexto por parcela: zonificación, riesgo de inundación y deslizamiento, registro de patrimonio, permisos de construcción y actividad de obra, acceso a transporte, uso agrícola del suelo y alrededores, direccionable por ID catastral

Solución de problemas

"Error: CENOGRAM_API_KEY is required" - Esto solo aplica al modo stdio. Asegúrate de que CENOGRAM_API_KEY esté configurada en el bloque env de tu configuración MCP. Para HTTP remoto, la clave va en el encabezado Authorization en su lugar.

npx se cuelga o falla - Verifica tu versión de Node.js con node -v. El modo stdio requiere Node.js >= 18. Si tienes una versión anterior, usa la opción HTTP remoto en su lugar (no necesita Node.js).

Una ubicación devuelve 0 resultados - El nombre puede no ser una unidad administrativa. Distritos y barrios son cosas diferentes: "Mokotow" es un distrito y funciona, "Sluzew" es un barrio dentro de él y no funciona. Usa list_locations(search="...") para encontrar nombres válidos, o busca por radio (search_by_area) para cualquier cosa más pequeña que un distrito.

401 No autorizado (modo HTTP) - El encabezado Authorization debe ser Bearer cngrm_... (con el prefijo Bearer). Verifica que se incluya la clave API completa, no solo el prefijo.

Desarrollo

git clone https://github.com/cenogram/mcp-server.git
cd mcp-server
npm install
npm test
npm run build

Licencia

MIT