deweloperuch.pl (unofficial)

deweloperuch-mcp

Website · Documentation in Polish , with a visual install guide

Ask an AI assistant about new-build apartments in Poland: asking prices with their history, real transaction prices and official statistics.

An unofficial MCP server and command-line tool over the public data of deweloperuch.pl: developers' asking prices (with price history), transaction prices from the Real Estate Price Register (RCN) and statistics of GUS, NBP and Eurostat. Thirteen read-only tools, usable from an MCP client such as Claude Desktop or Claude Code, or from the deweloperuch CLI.

Disclaimer. This is an independent project. It is not affiliated with, endorsed by or sponsored by deweloperuch.pl, GUS, NBP or the Register's publishers. The authors of deweloperuch.pl have agreed to the project's use of their service; the client identifies itself as deweloperuch-mcp/ with a link to this repository.

- It is read-only: it never creates or changes anything on the service.

- It is a polite client: at most 1 request per second, one at a time, shared by all processes on your machine; responses are cached; after a 401, 403, 429 or a captcha/WAF challenge it stops sending requests until you clear the lock yourself.

- Please respect the service. It is run by other people; ask narrow questions and do not build loops or bulk downloads on top of this tool.

- Data accuracy is not guaranteed. Prices are asking or registered prices, not valuations or advice.

- You are responsible for how you use the tool and the data, including the terms of the service.

What you can ask

• *Buying a flat:* "Find flats of 40–55 m² in Kraków's Podgórze up to 800 000 PLN, cheapest per m² first." (The service has no filter by number of rooms; filter by area instead.)
• *Judging an offer's price:* "Is this offer a good deal? Show its price history, the lowest price of the last 30 and 90 days, and whether the reduction looks suspicious."
• *Checking a developer:* "What does this developer build, and how many offers are active in which cities?"
• *Market and transaction prices:* "How do asking prices in Gdańsk compare with registered transaction prices over the last quarters?"
• *Valuation:* "Roughly what is a 55 m² flat at this address worth, based on nearby transactions?"
• *Comparing cities:* "Rank cities by transaction price per m², and show wages and unemployment next to them."

Install

Pick the first option that fits you; they go from no terminal to expert. Supported systems: macOS, Linux and Windows 10 (1903+) / 11 with a local NTFS cache directory.

Windows is supported starting with 0.1.3, including the PyPI package and .mcpb extension. Releases up to 0.1.2 support macOS and Linux only.

Prefer a visual walkthrough? The install guide on the project's website (in Polish) shows the installation step by step and has a prompt that lets an AI agent install it for you.

1. Claude Desktop, no terminal

1. Download deweloperuch-mcp- .mcpb from the latest release.
2. Double-click it, or drag it into Claude Desktop → Settings → Extensions → Install, then restart Claude Desktop.

You get: the 13 tools and 4 prompts in Claude Desktop. The extension uses the uv runtime (server.type is uv in its manifest), so the first start fetches Python and the dependencies and takes about a minute; you install nothing yourself. It has no command-line tool; if the server is ever stopped (STOP), see lifting a STOP without a checkout.

2. Any MCP client, with uv

You get: the same tools in Claude Desktop, Claude Code or any client that starts a stdio server. Nothing to clone.

Install uv once (macOS and Linux):

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows, use PowerShell (uv installation):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Open a new terminal after installation so it sees uv on PATH.

Claude Code:

claude mcp add deweloperuch -- uvx deweloperuch-mcp

Claude Desktop (claude_desktop_config.json; other clients use the same command and args):

{

"mcpServers": { "deweloperuch": { "command": "uvx", "args": ["deweloperuch-mcp"] } } }

To run straight from GitHub instead of PyPI, use uvx --from git+https://github.com/MBratkowski/deweloperuch-mcp@v0.1.3 deweloperuch-mcp (@v0.1.3 pins the release; drop it to follow main). pip install deweloperuch-mcp works too.

If a Windows MCP client cannot find uvx, use the full executable path from (Get-Command uvx).Source as command. Escape backslashes in JSON, for example "C:\\Users\\YOUR_NAME\\.local\\bin\\uvx.exe". A source checkout instead uses "command": "uv" and "args": ["run", "--directory", "C:\\path\\to\\deweloperuch-mcp", "deweloperuch-mcp"].

3. Agent skill for the CLI

You get: an AI coding agent that knows how to use the deweloperuch CLI (which command to call, how to read the output, what to do on STOP), without an MCP server. The skill is called deweloperuch-cli; a new agent session loads it by itself.

npx skills add MBratkowski/deweloperuch-mcp

This uses the skills CLI (needs Node.js) and works with any agent it supports; you choose the agent. Without Node.js:

uvx --from deweloperuch-mcp deweloperuch skill install

It writes to ~/.claude/skills/deweloperuch-cli (Claude Code, for the user). Options: --project (this project's ./.claude/skills), --agent codex|cursor|gemini-cli|github-copilot, --dir PATH (writes PATH/deweloperuch-cli), --force (replace a different copy; without it a changed copy is never overwritten, and the installer never writes through symlinks). deweloperuch skill show prints the skill, deweloperuch skill path its folder. Details: docs/cli/commands/skill.md.

Claude Code plugin marketplace:

/plugin marketplace add MBratkowski/deweloperuch-mcp

/plugin install deweloperuch@deweloperuch-mcp

4. The CLI on its own

You get: the deweloperuch command for your terminal and scripts; see docs/cli/README.md.

uvx --from deweloperuch-mcp deweloperuch --help    # one-off, nothing installed

uv tool install deweloperuch-mcp # installs deweloperuch and deweloperuch-mcp deweloperuch locations search krak

5. From source (contributors)

Requirements: Python 3.11 or newer and uv.

git clone https://github.com/MBratkowski/deweloperuch-mcp.git

cd deweloperuch-mcp uv sync uv run deweloperuch --help # sends no requests

As the client command use uv run --directory /path/to/deweloperuch-mcp deweloperuch-mcp (Claude Code: claude mcp add deweloperuch -- uv run --directory /path/to/deweloperuch-mcp deweloperuch-mcp). More: CONTRIBUTING.md and docs/mcp/README.md.

Troubleshooting

• `uvx: command not found` or `spawn uvx ENOENT`: install uv (option 2). Claude Desktop may not see your shell PATH, so put the full path from which uvx (macOS/Linux) or (Get-Command uvx).Source (PowerShell) in command.
• The server does not appear in Claude Desktop: quit and restart Claude Desktop after installing the extension or editing the config.
• Windows with release 0.1.2 or earlier: update to 0.1.3 or newer. For a uv tool installation, run uv tool upgrade deweloperuch-mcp; for pip, run python -m pip install --upgrade deweloperuch-mcp; for uvx, run uvx --refresh deweloperuch-mcp --help. Replace an older .mcpb extension with the latest release.
• STOP / exit code 3: after a 401, 403, 429 or a captcha/WAF challenge the client stops sending requests in every process, so as not to burden the service. A 429 expires by itself after the pause (at least 60 s). The other causes last until you lift them, after checking the cause (deweloperuch stop status shows the state; an AI agent must not lift it). The MCP server stays halted until you restart it. Details and the command: docs/configuration.md.
• Where is the cache? Responses are cached in memory only. The limiter lock and the STOP record live in ~/.cache/deweloperuch-mcp ($XDG_CACHE_HOME/deweloperuch-mcp). Do not delete that directory: it would also lift a STOP.

Tools

Overview, argument rules, errors and result sizes: docs/mcp/README.md.

| rank_locations | A ranking of p