IleZa.pl

Official4 tools

by bahdanhal · PHP

Editorial fair prices for products in Poland, plus a Polish net salary and tax calculator.

Model Context Protocol (MCP) Server: io.github.bahdanhal/ileza

The MCP server io.github.bahdanhal/ileza provides editorial fair prices for products in Poland, along with tools to calculate Polish net salary and taxes.

🛠️ Key Features

Editorial fair prices for products in Poland
Polish net salary calculator
Polish tax calculator

🚀 Use Cases

Determine fair pricing context for Polish product pricing
Convert Polish gross salary to net salary
Estimate tax outcomes for Polish income scenarios

⚡ Developer Benefits

Exposes pricing and Polish payroll/tax calculation capabilities via MCP

⚠️ Limitations

Description only specifies Poland-focused pricing and calculators (no other regions or additional tools are indicated)

Captured live from the server via tools/list.

calculate_polish_income_comparison

Calculate Polish contract and tax net income comparison for a company budget or UoP gross across UoP (employment), Umowa Zlecenie (mandate), Umowa o Dzieło (work contract), B2B (progressive, linear 19%, lump-sum/ryczałt), and Spółka z o.o. (board member resolution).

Parameters10

budget	number	optional	Total monthly company employer budget in PLN (e.g. 15000).
taxation	string	optional	B2B taxation type: progressive, linear, or lump.
zus	string	optional	B2B ZUS type: standard, preferential, or start.
lumpRate	number	optional	B2B lump sum tax rate percentage if taxation is lump (e.g. 12, 15, 8.5).
costs	number	optional	Monthly business operating costs in PLN for B2B.
studentUnder26	boolean	optional	Whether the mandate contractor is a student under 26 (exempt from ZUS and PIT up to limit).
llcCosts	number	optional	Monthly accounting and operating costs in PLN for Spółka z o.o. (default 600 PLN).
inputMode	string	optional	Input mode: budget (total employer cost) or uop_gross (gross employment contract).
grossUop	null \| number	optional	Gross employment contract salary if inputMode is uop_gross.
uopUnder26	boolean	optional	Whether the employment (UoP) employee is under 26 (exempt from PIT up to limit).

Raw schema

{
  "type": "object",
  "properties": {
    "budget": {
      "type": "number",
      "default": 12000,
      "description": "Total monthly company employer budget in PLN (e.g. 15000)."
    },
    "taxation": {
      "type": "string",
      "default": "progressive",
      "description": "B2B taxation type: progressive, linear, or lump."
    },
    "zus": {
      "type": "string",
      "default": "standard",
      "description": "B2B ZUS type: standard, preferential, or start."
    },
    "lumpRate": {
      "type": "number",
      "default": 12,
      "description": "B2B lump sum tax rate percentage if taxation is lump (e.g. 12, 15, 8.5)."
    },
    "costs": {
      "type": "number",
      "default": 0,
      "description": "Monthly business operating costs in PLN for B2B."
    },
    "studentUnder26": {
      "type": "boolean",
      "default": false,
      "description": "Whether the mandate contractor is a student under 26 (exempt from ZUS and PIT up to limit)."
    },
    "llcCosts": {
      "type": "number",
      "default": 600,
      "description": "Monthly accounting and operating costs in PLN for Spółka z o.o. (default 600 PLN)."
    },
    "inputMode": {
      "type": "string",
      "default": "budget",
      "description": "Input mode: budget (total employer cost) or uop_gross (gross employment contract)."
    },
    "grossUop": {
      "type": [
        "null",
        "number"
      ],
      "default": null,
      "description": "Gross employment contract salary if inputMode is uop_gross."
    },
    "uopUnder26": {
      "type": "boolean",
      "default": false,
      "description": "Whether the employment (UoP) employee is under 26 (exempt from PIT up to limit)."
    }
  }
}

list_polish_fair_price_products

List products tracked by IleZa.pl for manual editorial fair-price history in Poland.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_polish_fair_price_product

Get full product specification, family grouping, and media details for a product slug.

Parameters1

slug

string

required

Product slug returned by list_polish_fair_price_products.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Product slug returned by list_polish_fair_price_products."
    }
  },
  "required": [
    "slug"
  ]
}

get_polish_fair_price_history

Get dated manual editorial fair-price estimates for one exact product definition in Poland.

Parameters1

slug

string

required

Product slug returned by list_polish_fair_price_products.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Product slug returned by list_polish_fair_price_products."
    }
  },
  "required": [
    "slug"
  ]
}

README.md4 KBView on GitHub

IleZa.pl (`ileza`)

Live website: IleZa.pl - editorial fair prices and Polish salary calculator

Manual editorial fair-price histories for products in Poland, paired with a private browser-based salary and income calculator.

Shared Packagist packages: bahdan/symfony-privacy-analytics-bundle · bahdan/lead-capture-bundle

1. Overview

IleZa.pl ("Ile za?") publishes transparent editorial judgments about what products are reasonably worth without premiums for novelty, packaging, marketing, or large retail markups. 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 manual editorial price estimates.
Product History (/ceny/{slug}, EN: /prices/{slug}): Dated editorial fair prices, reasonable 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

bash

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.

Install

Tools (4)

calculate_polish_income_comparisonlist_polish_fair_price_productsget_polish_fair_price_productget_polish_fair_price_history

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://ileza.pl/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ileza": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ileza.pl/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: io.github.bahdanhal/ileza

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

calculate_polish_income_comparison

list_polish_fair_price_products

get_polish_fair_price_product

get_polish_fair_price_history

IleZa.pl (ileza)

1. Overview

Core Features & Canonical Routes:

Price research queue

2. Verification

3. Privacy & Security Invariants

Install

Remote endpoint

Related servers

IleZa.pl (`ileza`)