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

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.

Installation

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

One command - zero config files:

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

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

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

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

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

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

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.

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

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

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