📦

Cenogram — Polish Real Estate Data

Access 7M+ Polish real estate transactions. Search by location, parcel, area, or polygon.

0 installs

Trust: 37 — Low

Blockchain

Ask AI about Cenogram — Polish Real Estate Data

I know everything about Cenogram — Polish Real Estate Data. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

Cenogram MCP Server

Polish Real Estate Transaction Data for AI

MCP server for Polish real estate data. Access 7M+ real estate transactions from the national Registry of Prices and Values (Rejestr Cen Nieruchomosci, RCN) directly from Claude, Cursor, or any MCP-compatible AI assistant.

Data source: Polish national RCN registry (Rejestr Cen Nieruchomosci) | Platform: cenogram.pl

Get your API key

Go to cenogram.pl/api
Enter your email
You'll receive your cngrm_... API key by email

Manage your keys at cenogram.pl/ustawienia.

Installation

Pick your client. All options below use the hosted server - no local install needed (except npx/stdio).

Claude Code

One command - zero config files:

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

Cursor

Add to .cursor/mcp.json in your project:

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

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

HTTP remote (Claude Desktop 0.9+):

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

Stdio fallback (older versions - requires Node.js >= 18):

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

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

HTTP remote:

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

If HTTP doesn't work, use the npx (stdio) option below instead.

Cline

In VS Code: Settings > Cline > MCP Servers. Add:

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

npx (stdio) - local/offline

Requires Node.js >= 18. Use this if you want to run the server locally instead of connecting to the hosted one.

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

Client	Config file
Cursor	`.cursor/mcp.json`
Claude Code	`.mcp.json` in your project
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Cline	VS Code settings > Cline > MCP Servers

Configuration

Env Variable	Required	Default	Description
`CENOGRAM_API_KEY`	Yes (stdio)	-	API key from cenogram.pl/api
`CENOGRAM_API_URL`	No	`https://cenogram.pl`	API base URL
`MCP_TRANSPORT`	No	`stdio`	Set to `http` for Streamable HTTP mode
`MCP_PORT`	No	`3002`	HTTP server port (HTTP mode only)
`CENOGRAM_CLIENT_ID`	No	auto-generated	Persistent client identifier

You can also use the --http CLI flag instead of MCP_TRANSPORT=http.

Example Prompts

Polish:

"Jaka jest mediana cen mieszkan w Krakowie w 2025?"
"Pokaz transakcje z ulicy Pulawskiej 15 na Mokotowie"
"Znajdz transakcje na dzialce 146518_8.0108.27"
"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"

English:

"What's the median apartment price in Krakow in 2025?"
"Show transactions at Pulawska 15 in Mokotow"
"Find all transactions on parcel 146502_8.0901.12 and then search nearby"
"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"

Tools

Tool	Description	Key Parameters
`search_transactions`	Search transactions with filters	location, street, buildingNumber, parcelId, propertyType, marketType, price/date/area range
`get_price_statistics`	Price/m2 stats by location (residential only)	location (optional)
`get_price_distribution`	Price histogram	bins, maxPrice
`search_by_area`	Search by geographic radius	latitude, longitude, radiusKm
`get_market_overview`	Database overview and stats	(none)
`list_locations`	List available locations	search (optional)
`search_parcels`	Search parcels by cadastral ID prefix	q (parcel ID prefix, min 3 chars)
`search_by_polygon`	Search within a GeoJSON polygon	polygon, propertyType, dateFrom/dateTo
`compare_locations`	Compare stats across 2-5 districts	districts (comma-separated), propertyType

Location naming

Most cities: use the city name directly (e.g., "Gdansk", "Lublin")
Warsaw: use district names ("Mokotow", "Srodmiescie", "Wola") -- "Warszawa" won't match
Krakow: use sub-districts ("Krakow-Podgorze", "Krakow-Srodmiescie") - plain "Krakow" won't match
Use list_locations to find valid names

Property types

Value	Polish	English
`land`	Grunt	Land plot
`building`	Budynek	Building
`developed_land`	Grunt zabudowany	Developed land
`unit`	Lokal	Apartment/unit

Workflows

Results include parcel IDs and GPS coordinates, enabling multi-step research:

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")

This mimics how a property appraiser finds comparable transactions for valuation reports.

Data

7M+ transactions from all of Poland (380+ counties)
Date range: 2003 - present
Source: Polish national RCN registry (Rejestr Cen Nieruchomosci)
Refresh: periodic updates from RCN

Troubleshooting

"Error: CENOGRAM_API_KEY is required" - This only applies to stdio mode. Make sure CENOGRAM_API_KEY is set in the env block of your MCP config. For HTTP remote, the key goes in the Authorization header instead.

npx hangs or fails - Check your Node.js version with node -v. The stdio mode requires Node.js >= 18. If you're on an older version, use the HTTP remote option instead (no Node.js needed).

"Warszawa" returns 0 results - Warsaw uses district names (Mokotow, Wola, Srodmiescie, Bemowo, etc.). Use list_locations(search="warsz") to find valid names. Same applies to Krakow (use "Krakow-Podgorze", "Krakow-Srodmiescie", etc.).

401 Unauthorized (HTTP mode) - The Authorization header must be Bearer cngrm_... (with the Bearer prefix). Double-check that the full API key is included, not just the prefix.

Development

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

License

MIT