pl.cityon/mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
cityon-mcp
Remote MCP server for cityon.pl: real estate listings and local businesses in Poland.
Read-only, no login. Endpoint: https://cityon.pl/mcp (Streamable HTTP). Registry name: pl.cityon/mcp.
About 38,000 property listings from real estate agencies across Poland (apartments, houses, plots, commercial premises, warehouses, garages, rooms; sale and rent), new-build units from statutory developer price lists and transaction prices from notarial deeds.
About 954,000 businesses and places with opening hours, addresses and categories.
Add it to Claude Code: claude mcp add --transport http cityon https://cityon.pl/mcp
Tools: search_properties, get_property, get_property_stats, list_investments, get_investment,
get_apartment_prices, search_businesses, get_business, list_categories, nearby.
The rest of this file is in Polish.
Serwer MCP cityon.pl. Daje asystentom AI (Claude, ChatGPT, Perplexity, Le Chat i innym klientom MCP) dostęp do katalogu firm i nieruchomości z cityon.pl. Tylko odczyt, bez logowania.
Nieruchomości: ok. 38 tys. ofert od biur nieruchomości z całej Polski (mieszkania, domy, działki, lokale użytkowe, hale, garaże, pokoje; sprzedaż i wynajem), plan rozbudowy do ok. 50 tys. ofert do końca 2026 roku, do tego lokale z ustawowych wykazów cen deweloperów i ceny transakcyjne z aktów notarialnych.
Transport: Streamable HTTP, adres
/mcp(bez sesji).Hosting: Cloudflare Workers, darmowy plan.
Dane: publiczne API backendu
https://cityon.pl/api/public/mcp/*.Ochrona: 60 zapytań na minutę z jednego IP (Cloudflare Rate Limiting), maks. 20 wyników, brak stronicowania, pamięć podręczna odpowiedzi 5 minut. Backend ma własny wspólny limit 600/min.
Narzędzia
Narzędzie | Co robi |
| firmy po nazwie lub rodzaju, opcjonalnie w mieście i kategorii |
| pełne dane jednej firmy (godziny, adres, www, ocena, telefon gdy właściciel pozwala) |
| kategorie z liczbą firm, w mieście albo w całej Polsce |
| najbliższe firmy wokół punktu, promień do 10 km |
| oferty nieruchomości w mieście lub w promieniu do 50 km: mieszkania, domy, działki (z rodzajem), lokale użytkowe, hale, garaże, pokoje; sprzedaż lub wynajem; rynek pierwotny (wykazy deweloperów) i wtórny |
| jedna oferta lub lokal z wykazu, z historią ceny |
| liczba ofert wg rodzaju i transakcji, w mieście albo w Polsce (z miastami o największej liczbie ofert) |
| inwestycje deweloperskie w mieście |
| jedna inwestycja z 10 najtańszymi lokalami |
| ceny transakcyjne z aktów notarialnych (Rejestr Cen Nieruchomości) |
Każdy wynik zawiera kanoniczny link do cityon.pl (pole url).
Działki, lokale, hale, garaże, pokoje, wynajem, promień wokół miasta i get_property_stats wymagają backendu
z MR https://gitlab.com/cityon/backend/-/merge_requests/636. Na starszym backendzie narzędzie odpowiada krótkim
komunikatem, że opcja jest właśnie włączana, a mieszkania i domy na sprzedaż działają jak dotąd.
Related MCP server: ImotAI MCP Server
Test lokalny
npm install
cp .dev.vars.example .dev.vars # API_BASE=http://localhost:8788 (atrapa z danymi testowymi)
npm run dev:mock # atrapa backendu na :8788, w osobnym terminalu
npm run dev # Worker na http://localhost:8787/mcp
npm test # testy automatyczneGdy backend z /api/public/mcp/* jest już na produkcji, w .dev.vars ustaw API_BASE=https://cityon.pl
i testuj na prawdziwych danych.
MCP Inspector
npm run inspectorW przeglądarce: Transport Type Streamable HTTP, URL http://localhost:8787/mcp, Connect, zakładka Tools.
Z wiersza poleceń:
npx @modelcontextprotocol/inspector@2.9.0 --cli http://localhost:8787/mcp --transport http --method tools/list
npx @modelcontextprotocol/inspector@2.9.0 --cli http://localhost:8787/mcp --transport http \
--method tools/call --tool-name search_businesses --tool-arg query=pizzeria --tool-arg city=KrakówWdrożenie
Konto Cloudflare (darmowe) i logowanie w terminalu:
npx wrangler login.npm run deploy. Wrangler poda adreshttps://cityon-mcp.<twoja-subdomena>.workers.dev.Sekret dla nginx (dowolny losowy ciąg, min. 16 znaków):
npx wrangler secret put PROXY_SECRET. Ten sam ciąg wpisz w konfiguracji nginx niżej. Sekretu nie ma w repozytorium.Rekord DNS w home.pl:
mcp.cityon.pltypu A na adres naszego serwera, potem certyfikat (np.certbot --nginx -d mcp.cityon.pl).Nginx na naszym serwerze:
server {
listen 443 ssl http2;
server_name mcp.cityon.pl;
# ssl_certificate ... (z certbota)
location / {
proxy_pass https://cityon-mcp.<twoja-subdomena>.workers.dev;
proxy_ssl_server_name on;
proxy_set_header Host cityon-mcp.<twoja-subdomena>.workers.dev;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Cityon-Proxy "<PROXY_SECRET>";
proxy_http_version 1.1;
proxy_buffering off; # odpowiedzi strumieniowe (SSE)
proxy_read_timeout 120s;
}
}Bez X-Cityon-Proxy Worker widziałby adres naszego serwera zamiast adresu klienta, a limit na IP
objąłby wszystkich naraz.
Sprawdzenie: curl https://mcp.cityon.pl/health zwraca {"ok": true}.
Podłączenie w klientach
Adres serwera: https://mcp.cityon.pl/mcp (przed konfiguracją nginx działa też adres workers.dev + /mcp).
Claude (claude.ai i aplikacja)
Ustawienia, Connectors, Add custom connector. Nazwa cityon, URL https://mcp.cityon.pl/mcp, bez uwierzytelniania.
Potem w rozmowie włącz konektor w menu narzędzi.
Claude Code
claude mcp add --transport http cityon https://mcp.cityon.pl/mcp
ChatGPT (tryb deweloperski)
Ustawienia, Apps & Connectors, Advanced settings, włącz Developer mode. Potem Create (nowy konektor):
nazwa cityon, MCP Server URL https://mcp.cityon.pl/mcp, Authentication: No authentication.
W rozmowie wybierz tryb deweloperski i konektor cityon. Tryb deweloperski jest dostępny tylko w części planów.
Perplexity
Ustawienia, Connectors, dodanie własnego konektora zdalnego z adresem https://mcp.cityon.pl/mcp,
jeśli plan na to pozwala. Dostępność tej opcji zależy od planu i wersji aplikacji, warto sprawdzić przed testem.
Inne klienty (Le Chat, Cursor, VS Code i inne)
Dodaj serwer MCP typu „HTTP” lub „Streamable HTTP” z adresem https://mcp.cityon.pl/mcp, bez uwierzytelniania.
Zasady
Żadnych sekretów w repozytorium:
.dev.varsjest w.gitignore, sekrety tylko przezwrangler secret.W tekstach dla użytkowników (opisy narzędzi, komunikaty) bez półpauz i myślników typu em dash. Pilnuje tego test w
test/server.test.ts.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Real estate in Poland: about 5,000 property listings for sale and rent, plus local businesses
Polish real-estate deed prices and parcel checks: zoning plan, utilities, flood risk
Polish legal data for AI assistants: full-text search across 2.94M+ court rulings (common courts, Supreme Court, Constitutional Tribunal, KIO, NSA/WSA), statute text and version history from the official ELI register (164k+ acts), rulings citing a provision and citations between rulings, a citation verifier for case numbers, case-outcome and duration statistics, KIS tax interpretations, CJEU rulings applied in Poland, UODO decisions, KRS company lookup, court competence, official bank accounts and legal calculators. Works without an API key (daily limit).
Polish property on Gratka.pl/Morizon.pl (one database): flats, houses, plots, premises, buy or rent.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables searching Polish administrative areas and retrieving real estate transaction data from the official registry via geoportal.gov.pl.31GPL 3.0
- AlicenseAqualityBmaintenanceGives AI agents read-only access to Bulgarian real-estate data from imotai.bg, letting them list districts, search and fetch active listings, pull district-level market statistics, and estimate values from current asking prices. All results are field-allowlisted and rate limited, with no credentials, broker contact details, or written descriptions exposed.5MIT
- AlicenseNot gradedqualityBmaintenanceProvides AI assistants access to Polish public registers, enabling company lookups in KRS, VAT whitelist and bank-account checks, KRS extract retrieval, and offline validation of NIP, REGON, KRS, NRB, and KW numbers.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to query Polish new-build housing data: developers' asking prices with price history, real transaction prices from the RCN register, and GUS/NBP market statistics, plus searchable locations, offers, investments and developers. Exposes thirteen read-only tools over the public deweloperuch.pl data, usable from any MCP client or the bundled CLI.1358 PyPI29MIT