Cenogram - Polish Real Estate Prices & Parcel Data

Cenogram MCP Server

Polish Real Estate Transaction & Parcel Data for AI

MCP server for Polish real estate data. Access 8M+ real estate transactions from the national Registry of Prices and Values (Rejestr Cen Nieruchomosci, RCN) - prices from notarial deeds, not listings - directly from Claude, Cursor, ChatGPT, Grok, or any MCP-compatible AI assistant. Beyond transaction prices, the server resolves cadastral parcels and adds per-parcel context: zoning, flood and landslide risk, heritage register, building permits and construction activity, public transport access, agricultural land classification, surrounding land use, nature - nearby forest and overlapping protected areas - what lies underground (mining terrains and major groundwater reservoirs), the land-use and soil-quality classification, and road access.

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

Get your API key

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

Manage your keys at cenogram.pl/ustawienia.

Free tier

New accounts start with 1,000 tokens and a 14-day trial of the Standard plan. After that the key keeps working on 50 tokens a week - the balance is restored to 50 every 7 days rather than accumulating - with no expiry date and no card.

A call costs 1 token for statistics, reference data, parcel identity and municipal context; 3 for a transaction search (the list plus its summary; 1 with summaryOnly); 2 for a price histogram or a list of the parcels in an area; 4 for one context layer of a parcel or transaction; 5 for spatial search, parcel outlines, valuation and a multi-district comparison; 45 for get_parcel_report, which returns every layer at once. Location catalogues are free. Paid plans raise the allowance - see cenogram.pl/api.

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"

Codex CLI

API key. Add to ~/.codex/config.toml:

[mcp_servers.cenogram]

url = "https://mcp.cenogram.pl/mcp" bearer_token_env_var = "CENOGRAM_API_KEY"

Then export the key in the shell that starts Codex:

export CENOGRAM_API_KEY=cngrm_...

OAuth. Use the same block without bearer_token_env_var, then sign in:

[mcp_servers.cenogram]

url = "https://mcp.cenogram.pl/mcp"

codex mcp login cenogram

Without an API key or an OAuth login the server answers 401. Configuration keys differ between Codex versions, so check the Codex documentation for your version; this section does not guarantee that a particular version connects.

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

npx (stdio):

{

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

Configuration

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

Tips

• Model selection: For best results, use Claude Opus. It makes more sequential tool calls and produces richer analysis. You can switch the model in the dropdown at the bottom of the chat window.

Example Prompts

Polish:

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

English:

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

Tools

Location naming

• Most cities: use the city name directly (e.g., "Gdansk", "Lublin")
• Warsaw: "Warszawa" covers all 18 districts at once; name one ("Mokotow", "Srodmiescie", "Wola") to narrow it down
• Krakow and Lodz work the same way: the city name covers every sub-district, or name one ("Krakow-Podgorze")
• Neighbourhood names are not admi