@cenogram/mcp-server

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 and surrounding land use.

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

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

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.

Tips

• Model selection: For best results, use Claude Opus 4.7. 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

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
get_building_breakdown	Per-building breakdown for one transaction (footprint, storeys, est. floor area)	transaction_id (UUID from a search result)
get_parcel_report	Composite dossier for one parcel: core, 9 enrichment layers, transaction history, local price context and municipal context	parcelId (cadastral id or UUID)
resolve_parcel	Resolve a cadastral parcel identifier to its canonical record	parcelId or q (id prefix), or lat + lng
get_demographics	Population and demographic context for a location	location or teryt, year (or yearFrom/yearTo), category
get_infrastructure_signals	Municipal infrastructure signals (tenders, utilities, capital spending)	location or teryt
estimate_value	Comparable-sales value estimate for a property	area, plus lat + lng or parcelId; rooms, market
get_transaction_flood	Flood risk for the property in a transaction	transaction_id (UUID from a search result)
get_transaction_heritage	Heritage-register status for the property	transaction_id
get_transaction_landslide	Landslide risk for the property	transaction_id
get_transaction_surroundings	Nuisance and land-use context around the property	transaction_id
get_transaction_transit	Public transport accessibility for the property	transaction_id
get_transaction_permits	Building permits recorded for the property	transaction_id
get_transaction_planning	Local zoning and planning status for the property	transaction_id
get_transaction_farmland	Agricultural land-use classification for the property	transaction_id

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 administrative units - search by radius or polygon instead
• 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

• 8M+ transactions from all of Poland (380 counties)
• Date range: 2003 - present
• Source: Polish national RCN registry (Rejestr Cen Nieruchomosci)
• Refresh: periodic updates from RCN
• Per-parcel context: zoning, flood and landslide risk, heritage register, building permits and construction activity, transit access, agricultural land use and surroundings, addressable by cadastral ID

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

A location returns 0 results - The name may not be an administrative unit. Districts and neighbourhoods are two different things: "Mokotow" is a district and works, "Sluzew" is a neighbourhood inside it and does not. Use list_locations(search="...") to find valid names, or search by radius (search_by_area) for anything smaller than a district.

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