IleZa.pl MCP server
Commit Nov 14, 2026Provides personal product price estimates in Poland and a Polish employment and tax comparison calculator.
Also known as bahdanhal/ileza, ileza
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.1.0
- Last commit
- Nov 14, 2026
- License
- MIT
What is IleZa.pl MCP?
IleZa.pl provides personal product price estimates in Poland and a Polish employment and tax comparison calculator.
Summary generated from the project's README
About IleZa.pl MCP server
IleZa.pl provides personal product price estimates for the Polish market alongside a specialized employment and tax comparison tool. Users can access a catalog of personal price judgments for various categories like electronics, vehicles, and cosmetics. The server also includes a browser-based calculator that compares different Polish contract types, such as B2B, Umowa Zlecenie, Umowa o Dzieło, and UoP, based on 2026 tax rules.
Developers can interact with the service through the Model Context Protocol using tools for price lookups and tax calculations. The server includes specific administrative tools like get_next_price_research_batch, which retrieves up to fifty products for price research, and record_price_observation for submitting verified data. It operates with a focus on privacy by using HMAC-SHA256 for IP hashing and ensuring that no marketplace scraping occurs automatically. The system is designed for both general price inquiries and structured data collection tasks.
What you can do with it
- 1Compare Polish employment contractsCalculate the differences between B2B and various employment agreements using 2026 tax rules.
- 2Submit verified price dataUpdate the database with new price observations for specific products.
Written from the project's README. Every use case is checked against a quote from it.
How to install IleZa.pl MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall IleZa.pl MCP in Claude Code
$ claude mcp add --transport http ileza https://ileza.pl/mcpInstall IleZa.pl MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ileza": {
"url": "https://ileza.pl/mcp"
}
}
}Install IleZa.pl MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ileza": {
"type": "http",
"url": "https://ileza.pl/mcp"
}
}
}Install IleZa.pl MCP in VS Code CLI
$ code --add-mcp '{"name":"ileza","type":"http","url":"https://ileza.pl/mcp"}'Install IleZa.pl MCP in Codex
$ codex mcp add ileza --url https://ileza.pl/mcpInstall IleZa.pl MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ileza] url = "https://ileza.pl/mcp"
Install IleZa.pl MCP in Gemini CLI
$ gemini mcp add -s user --transport http ileza https://ileza.pl/mcpInstall IleZa.pl MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ileza": {
"url": "https://ileza.pl/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebahdanhal/ileza is public and reachablegithub.com/bahdanhal/ileza ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/bahdanhal/ileza ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 279 msPass
README
View on GitHubIleZa.pl (ileza)
Live website: IleZa.pl - personal price estimates and Polish salary calculator
Personal price estimates and dated histories by Bahdan Hal for products in Poland, paired with a private browser-based salary and income calculator.
Related projects: Bahdan Hal - software engineering consulting · Stackhal - free developer and DevOps tools
Shared Packagist packages: bahdan/symfony-privacy-analytics-bundle · bahdan/lead-capture-bundle
1. Overview
IleZa.pl ("Ile za?") publishes Bahdan Hal’s personal opinion on what he would pay for a product. Different information and experiments inform these judgments; the author chooses the final price and has no single fixed methodology. It is designed to cover any product category, including electronics, vehicles, and cosmetics, alongside a browser-only Polish employment and tax comparison calculator.
Core Features & Canonical Routes:
- Fair-Price Catalog (
/, PL:/pl/): Catalog of products with the author’s personal price estimates. - Product History (
/ceny/{slug}, EN:/prices/{slug}): Dated personal price estimates, price ranges, availability, and historical changes. - Employment & Tax Calculator (
/kalkulator-wynagrodzen, EN:/salary-calculator): Browser-only comparison of UoP, Umowa Zlecenie, Umowa o Dzieło, and B2B from a single company employer budget using 2026 Polish tax rules. - Product Addition Request (
/zglos, EN:/request): Community submission queue for new models. - Price Tip Submission (
/ceny/{slug}/okazja, EN:/prices/{slug}/price-tip): Community price alerts for admin review. - Model Context Protocol (
POST /mcp): MCP tools for price lookups, tax calculations, and authenticated admin operations.
Price research queue
The authenticated get_next_price_research_batch MCP tool (with legacy alias get_next_polish_fair_price_batch)
returns up to twenty products by default (configurable up to 50 via limit), with exact definitions,
configurations, latest prices, availability, and observation dates. Products without observations come first,
followed by the oldest observation date and slug. Observations from today or yesterday in Europe/Warsaw
are excluded, including unavailable observations. The response includes eligible_count and has_more
for the current queue. Verified observations are submitted via record_price_observation (alias: update_polish_fair_price_observation).
Call it again after saving a verified batch. It reads observation histories in bulk on every call;
it does not make one database query per product or reserve work. Concurrent coordinators must
coordinate assignments separately. Optional exclude_slugs defers explicitly tracked products;
excluded products are not included in eligible_count and must remain in the coordinator's ledger.
Repeated calls without writes or exclusions return the same batch. An empty batch means no
eligible products under these freshness and exclusion rules, not proof that deferred work is complete.
2. Verification
docker build --target test -t bahdan-landing-test .
docker run --rm --env-file .env.example -e APP_ENV=test bahdan-landing-test vendor/bin/phpunit --fail-on-phpunit-notice
docker run --rm bahdan-landing-test vendor/bin/phpstan analyse --no-progress --memory-limit=512M
docker run --rm bahdan-landing-test vendor/bin/phpcs
3. Privacy & Security Invariants
- Zero Marketplace Scraping: The service never crawls marketplace pages automatically.
- Voluntary Community Price Tips: Submitted URLs are stripped of tracking parameters, never fetched automatically, stored privately for manual review, and automatically pruned after 90 days.
- IP Hashing: Client IP addresses are irreversibly hashed using HMAC-SHA256 before persistence.
- Database Isolation: PostgreSQL operates exclusively within an internal Docker network.
IleZa.pl MCP questions
How do I add IleZa.pl MCP to Claude Code?
Run claude mcp add --transport http ileza https://ileza.pl/mcp in your terminal. Add --scope user to make it available in every project.
How do I add IleZa.pl MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can the MCP tools do?
The MCP tools allow for price lookups, tax calculations, and authenticated admin operations.
How does the salary calculator work?
It is a browser-only tool that compares UoP, Umowa Zlecenie, Umowa o Dzieło, and B2B using 2026 Polish tax rules.