Back to Directory/Developer Tools

io.github.ContentWriterco/ceny-nieruchomosci-mcp

Polish real-estate deed prices and parcel checks: zoning plan, utilities, flood risk

Developer ToolsTypeScriptv0.2.0
Ty:     Za ile sprzedawały się mieszkania koło ul. Garbary 10 w Poznaniu?
Agent:  W promieniu 500 m w ostatnich 2 latach było 228 transakcji wolnorynkowych:
        mediana 12 048 zł/m² (połowa między 10 115 a 14 782 zł/m²), typowo 444 tys. zł za 39 m².
        1 pokój: 13 163 zł/m² · 2 pokoje: 13 069 zł/m² · 3 pokoje: 10 787 zł/m² · 4+: 9 629 zł/m².

Prawdziwy wynik z października 2026.

Podłącz w 30 sekund

Adres MCP: https://ceny.compabase.com/mcp (Streamable HTTP, bez logowania).

  • Claude: Ustawienia → Connectors → Add custom connector → wklej adres.
  • ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.
  • Claude Code: claude mcp add --transport http ceny https://ceny.compabase.com/mcp
  • Lokalnie (stdio): npx -y ceny-nieruchomosci-mcp, np. w Claude Desktop:
{ "mcpServers": { "ceny": { "command": "npx", "args": ["-y", "ceny-nieruchomosci-mcp"] } } }

Co potrafi

NarzędzieDo czego
property_pricesMieszkania, domy albo działki niezabudowane w promieniu od adresu, ulicy, miejscowości lub punktu: mediana ceny za m², rozrzut (25–75%), typowa cena i powierzchnia, ceny wg liczby pokoi, rynek pierwotny/wtórny, trend rok do roku i ostatnie transakcje (bez adresów). Filtry: pokoje, powierzchnia, okres, promień.
find_addressSprawdza adres w państwowym rejestrze adresów (GUGiK).
data_sourcesŹródła danych i zastrzeżenia.

Przykładowe pytania: „Ile kosztuje m² mieszkania przy Długiej w Krakowie?”, „Za ile sprzedają się domy w Swarzędzu?”, „Ceny działek budowlanych w Kórniku w ostatnich 3 latach”, „Czy 650 tys. za 3 pokoje 55 m² na Wildzie to dobra cena?”.

Skąd dane i jak liczymy

  • Rejestr Cen Nieruchomości prowadzony przez starostów, udostępniany bezpłatnie od 13.02.2026 (nowelizacja Prawa geodezyjnego i kartograficznego) przez krajową usługę GUGiK https://mapy.geoportal.gov.pl/wss/service/rcn. Adresy: państwowy geokoder GUGiK (UUG).
  • Liczymy tylko transakcje wolnorynkowe pełnej własności (bez sprzedaży z bonifikatą, przetargów gminnych i udziałów ułamkowych), mieszkania tylko o funkcji mieszkalnej (bez garaży i komórek), z odrzuceniem oczywistych błędów (np. dat z przyszłości).
  • Prywatność: nie pokazujemy numerów aktów, stron ani adresów lokali (usługa krajowa ich nie publikuje); transakcje podajemy z odległością od wskazanego punktu.
  • Zastrzeżenia: rejestr jest uzupełniany z opóźnieniem (ostatnie miesiące są niepełne), zasięg zależy od powiatów, a dla domów rejestr często nie podaje powierzchni użytkowej – wtedy podajemy cenę całej nieruchomości i powierzchnię działki.

Własny serwer

npx -y ceny-nieruchomosci-mcp --http --port 3000      # MCP: http://localhost:3000/mcp
npx -y ceny-nieruchomosci-mcp prices "Gdańsk, Długa 1" --rooms 2

Zmienne: CENY_MAX_RADIUS_M (1500), CENY_CACHE_MB (300), CENY_RATE_LIMIT, CENY_STATS=1 (anonimowe liczniki pod /stats), CENY_CONTACT, CENY_PUBLIC_URL.

Licencja

Kod: MIT. Dane: Rejestr Cen Nieruchomości – Główny Urząd Geodezji i Kartografii (dane przetworzone). Projekt niezależny, hostowany pro publico bono przez Compabase. Zobacz też rozkład-mcp – rozkłady jazdy PKP, PKS i komunikacji miejskiej dla AI.


English

ceny-nieruchomosci-mcp gives AI assistants real transaction prices of Polish real estate (flats, houses, building plots) from notarial deeds in the official Rejestr Cen Nieruchomości (GUGiK), not asking prices. property_prices returns the median price per m², interquartile range, breakdown by rooms, primary/secondary market, a yearly trend and recent sales within a radius of any Polish address, street, town or coordinates. Public endpoint: https://ceny.compabase.com/mcp (no key), or run locally with npx -y ceny-nieruchomosci-mcp.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y ceny-nieruchomosci-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-contentwriterco-ceny-nieruchomosci-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ceny-nieruchomosci-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

ceny-nieruchomosci-mcpnpm

Compatible MCP Clients

io.github.ContentWriterco/ceny-nieruchomosci-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More