polish-mcp-servers 0.1.2 → 0.1.4

package/README.md

@@ -1,8 +1,42 @@
 # Polish MCP servers
 
 [![Glama](https://glama.ai/mcp/servers/kamilkaczmareksolutions/polish-mcp-servers/badge)](https://glama.ai/mcp/servers/kamilkaczmareksolutions/polish-mcp-servers)
+[![npm](https://img.shields.io/npm/v/polish-mcp-servers)](https://www.npmjs.com/package/polish-mcp-servers)
+![License: MIT](https://img.shields.io/badge/license-MIT-blue)
 
-Local [Model Context Protocol](https://modelcontextprotocol.io) server for Polish public data. It speaks stdio and exposes 13 tools, one for each public Apify Actor by [enterprising_hamster](https://apify.com/enterprising_hamster).
+**Give Claude, Cursor or any MCP client one-command access to Polish public data: statutes, court judgments, KRS companies, company lookup by NIP/REGON, tenders, MSiG company announcements, Ukraine Prozorro tenders, building permits, land parcels, EV chargers, electricity prices and more (16 tools).**
+
+![Demo: an MCP client lists the 13 tools over stdio, then calls polish-new-companies-krs and gets one company back as JSON {items, truncated}](docs/demo.gif)
+
+<sub>Staged demo with sample output; real runs need an Apify token. The tool list is real; the company in the result is fictional, laid out the way the server returns it (`{items, truncated}` with the KRS Actor's dataset fields).</sub>
+
+## Why
+
+Polish public data is spread over a dozen official APIs and portals (Sejm ELI, SAOS, KRS, CEPiK, GUNB, ULDK, PSE, dane.gov.pl ...), each with its own format, paging and quirks. LLM agents can't use them out of the box. This server wraps them as MCP tools with typed input schemas and read-only annotations, so an agent can search acts, read a judgment, or pull EV chargers, building permits or electricity prices without you writing glue code.
+
+## Quick start
+
+```bash
+npx -y polish-mcp-servers          # all 16 tools
+```
+
+Then add it to your client (Claude Desktop, Cursor, VS Code: see [Configure Claude Desktop and Cursor](#configure-claude-desktop-and-cursor)) with `APIFY_TOKEN` in `env`.
+
+## How it works
+
+- Stdio MCP server built on `@modelcontextprotocol/sdk`. Three profiles: `polish-mcp-servers` (all 16 tools), `polish-law-mcp` (law only), `polish-public-registers` (the other 15).
+- The tool list, input schemas and descriptions come from a bundled catalog (`catalog/`), so `tools/list` needs no token and no network.
+- `tools/call` runs the matching public Apify Actor with `run-sync-get-dataset-items` (pinned build, up to 300 s) on your Apify account and returns the dataset items as JSON.
+
+## Limitations
+
+- Every `tools/call` starts a paid Apify Actor run, billed pay-per-event to the account behind `APIFY_TOKEN` (prices below). Listing tools is free.
+- Responses are capped at 100 items and 256 KiB of JSON per call.
+- Data is only as fresh and complete as the upstream public source.
+
+## Details
+
+Local [Model Context Protocol](https://modelcontextprotocol.io) server for Polish public data. It speaks stdio and exposes 16 tools, one for each public Apify Actor by [enterprising_hamster](https://apify.com/enterprising_hamster).
 
 `tools/list` answers with no `APIFY_TOKEN` and no network. `tools/call` runs that Actor on your Apify account. Create a token at [console.apify.com/settings/integrations](https://console.apify.com/settings/integrations) and set `APIFY_TOKEN`. A call without a token returns an MCP tool error that points at that page.
 
@@ -27,10 +61,13 @@ Each call returns at most 100 dataset items and at most 256 KiB of JSON. Pass `m
 | `polish-developer-apartment-prices` | Developer apartment and house offers, with price per m², from dane.gov.pl. | [Store](https://apify.com/enterprising_hamster/polish-developer-apartment-prices) |
 | `polish-electricity-market-pse` | PSE electricity prices and grid rows (RCE, day-ahead, imbalance, load, generation). | [Store](https://apify.com/enterprising_hamster/polish-electricity-market-pse) |
 | `polish-new-companies-krs` | New and changed companies from the KRS bulletin with NIP, REGON, PKD, and share capital. No personal data. | [Store](https://apify.com/enterprising_hamster/polish-new-companies-krs) |
+| `polish-company-lookup-regon` | Company lookup by NIP, REGON or KRS in the GUS REGON register: name, legal form, address, PKD, status, optional VAT status. No GUS key needed, no phone or email. | [Store](https://apify.com/enterprising_hamster/polish-company-lookup-regon) |
+| `ukraine-prozorro-tenders` | Ukraine Prozorro tenders with English fields, CPV, delivery oblast, UAH value, deadlines, and links. Daily only-new alerts. | [Store](https://apify.com/enterprising_hamster/ukraine-prozorro-tenders) |
+| `polish-company-announcements-msig` | Monitor Sądowy i Gospodarczy notices for companies and other legal entities, with KRS and court. Natural persons excluded. | [Store](https://apify.com/enterprising_hamster/polish-company-announcements-msig) |
 
 The full tool and parameter descriptions that clients see live in [`catalog/tool-descriptions.json`](catalog/tool-descriptions.json). Every tool is annotated `readOnlyHint: true`, `destructiveHint: false`, `idempotentHint: true`, `openWorldHint: true`: it only reads the public source, but each `tools/call` starts a paid Apify Actor run, billed pay-per-event to the Apify account behind `APIFY_TOKEN`, and waits up to 300 s for it.
 
-`polish-mcp-servers` and `polish-mcp` list all 13. `polish-law-mcp` lists only `polish-law-mcp-server`. `polish-public-registers` lists the other 12, including `cee-public-tenders`.
+`polish-mcp-servers` and `polish-mcp` list all 16. `polish-law-mcp` lists only `polish-law-mcp-server`. `polish-public-registers` lists the other 15, including `cee-public-tenders` and `ukraine-prozorro-tenders`.
 
 ## Install
 
@@ -118,7 +155,7 @@ Omit `APIFY_TOKEN` if you only want `tools/list`.
 The same data is also available as hosted MCP servers on [Apify](https://apify.com/enterprising_hamster). Point your client at a URL and authenticate with your Apify account. Those servers still run as Apify Actors.
 
 - **Polish Law MCP**: Polish statutes from the Sejm ELI API (Dziennik Ustaw, Monitor Polski) and court judgments from SAOS.
-- **Polish Public Registers**: 11 official Polish registers (EU-funded tenders, EV charging stations, vehicle registrations, building permits, land parcels and zoning, healthcare facilities, developer apartment prices, electricity market, new companies from KRS, legal acts, court judgments).
+- **Polish Public Registers**: 13 official Polish registers (EU-funded tenders, EV charging stations, vehicle registrations, building permits, land parcels and zoning, healthcare facilities, developer apartment prices, electricity market, new companies from KRS, company lookup in REGON, court and business gazette (MSiG), legal acts, court judgments).
 
 | Server | MCP Registry name | MCP URL (Streamable HTTP) |
 |---|---|---|
@@ -129,7 +166,7 @@ The same data is also available as hosted MCP servers on [Apify](https://apify.c
 ### Polish Public Registers URL
 
 ```
-https://mcp.apify.com/?tools=enterprising_hamster/polish-eu-funds-tenders-baza-konkurencyjnosci,enterprising_hamster/polish-ev-charging-stations-eipa,enterprising_hamster/polish-vehicle-registrations-cepik,enterprising_hamster/polish-building-permits-gunb,enterprising_hamster/polish-land-parcels-uldk-zoning,enterprising_hamster/polish-healthcare-facilities-rpwdl,enterprising_hamster/polish-developer-apartment-prices,enterprising_hamster/polish-electricity-market-pse,enterprising_hamster/polish-new-companies-krs,enterprising_hamster/polish-legal-acts-eli,enterprising_hamster/polish-court-judgments-saos
+https://mcp.apify.com/?tools=enterprising_hamster/polish-eu-funds-tenders-baza-konkurencyjnosci,enterprising_hamster/polish-ev-charging-stations-eipa,enterprising_hamster/polish-vehicle-registrations-cepik,enterprising_hamster/polish-building-permits-gunb,enterprising_hamster/polish-land-parcels-uldk-zoning,enterprising_hamster/polish-healthcare-facilities-rpwdl,enterprising_hamster/polish-developer-apartment-prices,enterprising_hamster/polish-electricity-market-pse,enterprising_hamster/polish-new-companies-krs,enterprising_hamster/polish-company-lookup-regon,enterprising_hamster/polish-company-announcements-msig,enterprising_hamster/polish-legal-acts-eli,enterprising_hamster/polish-court-judgments-saos
 ```
 
 You can drop Actors from the `tools=` list to expose only the registers you need.
@@ -160,7 +197,7 @@ Pricing (pay per event, FREE/BRONZE Apify plan tier):
 
 ### Polish Public Registers tools
 
-Each Actor is exposed as one MCP tool that runs the Actor. The Apify MCP server also adds four helper tools: `get-actor-run`, `get-dataset-items`, `get-key-value-store-record`, `abort-actor-run` (15 tools in total).
+Each Actor is exposed as one MCP tool that runs the Actor. The Apify MCP server also adds four helper tools: `get-actor-run`, `get-dataset-items`, `get-key-value-store-record`, `abort-actor-run` (17 tools in total).
 
 Prices are per delivered result, FREE/BRONZE Apify plan tier. Higher plan tiers pay less; see each Actor page.
 
@@ -175,6 +212,8 @@ Prices are per delivered result, FREE/BRONZE Apify plan tier. Higher plan tiers
 | Developer apartment prices (dane.gov.pl) | [polish-developer-apartment-prices](https://apify.com/enterprising_hamster/polish-developer-apartment-prices) | $0.002 offer; $0.004 price change |
 | Electricity market (PSE API) | [polish-electricity-market-pse](https://apify.com/enterprising_hamster/polish-electricity-market-pse) | $0.0003 market data row |
 | New and changed companies (KRS API, Ministry of Justice) | [polish-new-companies-krs](https://apify.com/enterprising_hamster/polish-new-companies-krs) | $0.004 company |
+| Company lookup by NIP, REGON, KRS (GUS REGON BIR1.2) | [polish-company-lookup-regon](https://apify.com/enterprising_hamster/polish-company-lookup-regon) | $0.003 company |
+| Court and business gazette (MSiG) | [polish-company-announcements-msig](https://apify.com/enterprising_hamster/polish-company-announcements-msig) | $0.003 announcement |
 | Legal acts (Sejm ELI) | [polish-legal-acts-eli](https://apify.com/enterprising_hamster/polish-legal-acts-eli) | $0.002 act metadata; $0.008 act with text |
 | Court judgments (SAOS) | [polish-court-judgments-saos](https://apify.com/enterprising_hamster/polish-court-judgments-saos) | $0.003 judgment metadata; $0.01 judgment with full text |
 
@@ -207,7 +246,7 @@ Cursor, `~/.cursor/mcp.json` or `.cursor/mcp.json` in a project:
       }
     },
     "polish-public-registers": {
-      "url": "https://mcp.apify.com/?tools=enterprising_hamster/polish-eu-funds-tenders-baza-konkurencyjnosci,enterprising_hamster/polish-ev-charging-stations-eipa,enterprising_hamster/polish-vehicle-registrations-cepik,enterprising_hamster/polish-building-permits-gunb,enterprising_hamster/polish-land-parcels-uldk-zoning,enterprising_hamster/polish-healthcare-facilities-rpwdl,enterprising_hamster/polish-developer-apartment-prices,enterprising_hamster/polish-electricity-market-pse,enterprising_hamster/polish-new-companies-krs,enterprising_hamster/polish-legal-acts-eli,enterprising_hamster/polish-court-judgments-saos",
+      "url": "https://mcp.apify.com/?tools=enterprising_hamster/polish-eu-funds-tenders-baza-konkurencyjnosci,enterprising_hamster/polish-ev-charging-stations-eipa,enterprising_hamster/polish-vehicle-registrations-cepik,enterprising_hamster/polish-building-permits-gunb,enterprising_hamster/polish-land-parcels-uldk-zoning,enterprising_hamster/polish-healthcare-facilities-rpwdl,enterprising_hamster/polish-developer-apartment-prices,enterprising_hamster/polish-electricity-market-pse,enterprising_hamster/polish-new-companies-krs,enterprising_hamster/polish-company-lookup-regon,enterprising_hamster/polish-company-announcements-msig,enterprising_hamster/polish-legal-acts-eli,enterprising_hamster/polish-court-judgments-saos",
       "headers": {
         "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
       }
@@ -251,7 +290,7 @@ Look them up at `https://registry.modelcontextprotocol.io/v0.1/servers?search=ka
 
 ## Data sources
 
-All data comes from official Polish public registers and open-data APIs: Sejm ELI, SAOS, Baza Konkurencyjności, EIPA (UDT), CEPiK, GUNB, GUGiK ULDK, RPWDL, dane.gov.pl, PSE, KRS. Personal data is limited. Building-permit investors who are private persons are anonymised, private EV station operators are anonymised, CEPiK data is aggregated (no VINs or owners), ULDK parcels come without owners, and KRS rows carry company-level fields only (no board members or shareholders).
+All data comes from official Polish public registers and open-data APIs: Sejm ELI, SAOS, Baza Konkurencyjności, EIPA (UDT), CEPiK, GUNB, GUGiK ULDK, RPWDL, dane.gov.pl, PSE, KRS, GUS REGON, MSiG (Monitor Sądowy i Gospodarczy). The `ukraine-prozorro-tenders` tool reads the official Prozorro API and is not a Polish register, same as `cee-public-tenders`. Personal data is limited. Building-permit investors who are private persons are anonymised, private EV station operators are anonymised, CEPiK data is aggregated (no VINs or owners), ULDK parcels come without owners, KRS rows carry company-level fields only (no board members or shareholders), REGON rows carry no phone, fax or email, and MSiG notices about natural persons are excluded with `fullText` off unless the caller asks for it.
 
 ## License
 

package/catalog/actors.json

@@ -2502,5 +2502,339 @@
         }
       }
     }
+  },
+  {
+    "actorId": "enterprising_hamster/polish-company-lookup-regon",
+    "name": "polish-company-lookup-regon",
+    "title": "Poland Company Lookup API – REGON, NIP, KRS",
+    "description": "Look up a Polish company by NIP, REGON or KRS in the official GUS REGON register: name, address, PKD, dates and optional VAT status. No phone, fax or email. For KYC, CRM and AI agents (MCP).",
+    "isPublic": true,
+    "buildId": "AEMWS4UulvF2UZSUU",
+    "buildNumber": "0.1.3",
+    "inputSchema": {
+      "title": "Poland company lookup (REGON)",
+      "type": "object",
+      "schemaVersion": 1,
+      "properties": {
+        "nips": {
+          "title": "NIP numbers",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Tax identifiers (NIP). Spaces, hyphens and a leading PL are ignored. Invalid checksums are returned as found=false and are not charged.",
+          "default": [
+            "7740001454",
+            "6920000013",
+            "5250007738",
+            "5260250274"
+          ]
+        },
+        "regons": {
+          "title": "REGON numbers",
+          "type": "array",
+          "editor": "stringList",
+          "description": "9-digit subjects or 14-digit local units. Checksums are validated.",
+          "default": [
+            "000331501"
+          ]
+        },
+        "krsNumbers": {
+          "title": "KRS numbers",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Court numbers. Shorter values are zero-padded to 10 digits. Looked up one at a time.",
+          "default": []
+        },
+        "identifiers": {
+          "title": "Mixed identifiers",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Optional prefixes NIP:, REGON: and KRS:. Without a prefix, 9 or 14 digits are a REGON and 10 digits with a valid NIP checksum are a NIP. Anything else returns the error \"ambiguous, use prefix\".",
+          "default": []
+        },
+        "gusApiKey": {
+          "title": "GUS API key",
+          "type": "string",
+          "editor": "textfield",
+          "description": "Optional. Your own production BIR1 user key from GUS. Leave empty: the Actor uses its own production key.",
+          "isSecret": true
+        },
+        "useTestEnvironment": {
+          "title": "Use GUS test environment",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "When no production key is set, call the public GUS test service. Data is anonymized and frozen around 8 November 2014. Ignored when a key is set.",
+          "default": false
+        },
+        "includeLocalUnits": {
+          "title": "Include local units",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Nest up to 50 local units (14-digit REGON) on each company. No extra charge. A 14-digit REGON in the input is its own row.",
+          "default": false
+        },
+        "includeSoleTraders": {
+          "title": "Include sole traders",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "When false, a sole trader (JDG) is returned with found=true and skipped=sole_trader and is not charged.",
+          "default": true
+        },
+        "soleTraderFullAddress": {
+          "title": "Full address for sole traders",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Include street, building and apartment for a sole trader. Default is city, postal code, municipality, county and voivodeship only.",
+          "default": false
+        },
+        "checkVatStatus": {
+          "title": "Check VAT status",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Ask the Ministry of Finance WL2 status method. Adds vatStatus, vatCheckedAt and vatRequestId. On failure the company is still returned with vatError. No bank accounts and no people.",
+          "default": false
+        },
+        "maxItems": {
+          "title": "Max companies",
+          "type": "integer",
+          "editor": "number",
+          "description": "Stop after this many charged companies. Empty means no cap. Not-found rows and skipped sole traders do not count.",
+          "minimum": 1
+        }
+      }
+    }
+  },
+  {
+    "actorId": "enterprising_hamster/ukraine-prozorro-tenders",
+    "name": "ukraine-prozorro-tenders",
+    "title": "Ukraine Prozorro Tenders API – English, CPV & Daily Alerts",
+    "description": "Ukraine public tenders from the official Prozorro API for foreign contractors and reconstruction work: CPV, keywords, delivery oblast, UAH value, deadlines, links. Daily only-new alerts. JSON, CSV, Excel.",
+    "isPublic": true,
+    "buildId": "Uw5LNJaa3bYp5QL6m",
+    "buildNumber": "0.1.3",
+    "inputSchema": {
+      "schemaVersion": 1,
+      "title": "Ukraine Prozorro tenders input",
+      "type": "object",
+      "properties": {
+        "lastDays": {
+          "title": "Modified in the last N days",
+          "type": "integer",
+          "editor": "number",
+          "minimum": 1,
+          "maximum": 90,
+          "description": "Walk the modification feed newest first until dateModified is older than this window. Publication filters apply on the tender document.",
+          "default": 1,
+          "prefill": 1
+        },
+        "onlyOpen": {
+          "title": "Only open competitive tenders",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Keep active.enquiries and active.tendering only. Direct awards (reporting, negotiation) are always excluded.",
+          "default": true,
+          "prefill": true
+        },
+        "includeDetails": {
+          "title": "Include description text",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "When enabled, store Prozorro's description and charge the tender-with-details event.",
+          "default": false,
+          "prefill": false
+        },
+        "maxItems": {
+          "title": "Maximum tenders to save",
+          "type": "integer",
+          "editor": "number",
+          "minimum": 1,
+          "maximum": 10000,
+          "description": "Stop scheduling new detail requests once this many rows are pushed.",
+          "default": 50,
+          "prefill": 50
+        },
+        "maxRequestsPerSecond": {
+          "title": "Maximum requests per second",
+          "type": "number",
+          "editor": "number",
+          "minimum": 0.2,
+          "maximum": 5,
+          "description": "Minimum spacing between list and detail HTTP starts. The list docs describe a separate sync cadence of about five minutes, which is not this cap.",
+          "default": 5,
+          "prefill": 5
+        },
+        "onlyNew": {
+          "title": "Only tenders not seen before",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Skip ids stored under stateKey in the ukraine-prozorro-seen key-value store (50,000 ids per key).",
+          "default": false,
+          "prefill": false
+        },
+        "stateKey": {
+          "title": "State key for only-new runs",
+          "type": "string",
+          "editor": "textfield",
+          "isSecret": true,
+          "description": "Key in the seen store when onlyNew is true. Use a unique name per alert task."
+        },
+        "keywords": {
+          "title": "Keywords",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Optional. Keep tenders whose title, English title, description, or item text contains any keyword (case- and accent-insensitive).",
+          "default": [],
+          "prefill": []
+        },
+        "cpvCodes": {
+          "title": "CPV prefixes",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Optional. Match any item CPV code that starts with the given prefix (2–8 digits). The list API cannot filter by CPV.",
+          "default": [],
+          "prefill": []
+        },
+        "regions": {
+          "title": "Delivery oblasts",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Optional. Match items[].deliveryAddress.region as published (for example Херсонська область). Buyer address is not used.",
+          "default": [],
+          "prefill": []
+        },
+        "minValueUah": {
+          "title": "Minimum value (UAH)",
+          "type": "number",
+          "editor": "number",
+          "minimum": 0,
+          "description": "Optional. Tenders without UAH value fail this filter."
+        },
+        "maxValueUah": {
+          "title": "Maximum value (UAH)",
+          "type": "number",
+          "editor": "number",
+          "minimum": 0,
+          "description": "Optional. Tenders without UAH value fail this filter."
+        }
+      }
+    }
+  },
+  {
+    "actorId": "enterprising_hamster/polish-company-announcements-msig",
+    "name": "polish-company-announcements-msig",
+    "title": "Poland Court & Business Gazette API – MSiG Announcements",
+    "description": "Daily Monitor Sądowy i Gospodarczy (Polish Court and Business Gazette) notices about companies and other legal entities: bankruptcy, restructuring, liquidation, mergers, transformations, creditor calls, with KRS and court. Natural persons excluded. JSON, CSV, Excel.",
+    "isPublic": true,
+    "buildId": "r9zsaPD1AtiXU36Yw",
+    "buildNumber": "0.1.4",
+    "inputSchema": {
+      "schemaVersion": 1,
+      "title": "Poland MSiG announcements input",
+      "type": "object",
+      "properties": {
+        "lastDays": {
+          "title": "Last N calendar days",
+          "type": "integer",
+          "editor": "number",
+          "minimum": 1,
+          "maximum": 90,
+          "description": "Keep issues whose cover date is on or after today minus N-1 days. Ignored when dateFrom or dateTo is set. Default 1 is today's issue only.",
+          "default": 1,
+          "prefill": 1
+        },
+        "dateFrom": {
+          "title": "Issue date from",
+          "type": "string",
+          "editor": "textfield",
+          "description": "Inclusive ISO date (YYYY-MM-DD). When set, lastDays is ignored."
+        },
+        "dateTo": {
+          "title": "Issue date to",
+          "type": "string",
+          "editor": "textfield",
+          "description": "Inclusive ISO date (YYYY-MM-DD). When set, lastDays is ignored."
+        },
+        "announcementKinds": {
+          "title": "Announcement kinds",
+          "type": "array",
+          "editor": "select",
+          "items": {
+            "type": "string",
+            "enum": [
+              "bankruptcy",
+              "restructuring",
+              "liquidation",
+              "merger",
+              "demerger",
+              "transformation",
+              "dissolution",
+              "creditor_call",
+              "other"
+            ]
+          },
+          "description": "Optional. Keep only these kinds. Empty means every legal-entity notice.",
+          "default": [],
+          "prefill": []
+        },
+        "keywords": {
+          "title": "Keywords",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Matched against the entity name, the legal form, the chapter line, the subsection line, the kind, and KRS. The notice body is not searched.",
+          "default": [],
+          "prefill": []
+        },
+        "krsNumbers": {
+          "title": "KRS numbers",
+          "type": "array",
+          "editor": "stringList",
+          "description": "Optional. Keep notices whose header KRS matches (6-10 digits, padded to 10).",
+          "default": [],
+          "prefill": []
+        },
+        "fullText": {
+          "title": "Include full notice text",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Off by default. When on, fullText is the notice body and can name liquidators, shareholders, and other people. Turn it on only when you have a legal basis to store that text. Notices about natural persons are never returned.",
+          "default": false,
+          "prefill": false
+        },
+        "maxItems": {
+          "title": "Maximum announcements to save",
+          "type": "integer",
+          "editor": "number",
+          "minimum": 1,
+          "maximum": 10000,
+          "description": "Stop pushing once this many legal-entity rows are saved.",
+          "default": 50,
+          "prefill": 50
+        },
+        "maxRequestsPerSecond": {
+          "title": "Maximum requests per second",
+          "type": "number",
+          "editor": "number",
+          "minimum": 0.2,
+          "maximum": 5,
+          "description": "Minimum spacing between GetFiles and PDF download requests to the Ministry site.",
+          "default": 1,
+          "prefill": 1
+        },
+        "onlyNew": {
+          "title": "Only announcements not seen before",
+          "type": "boolean",
+          "editor": "checkbox",
+          "description": "Skip ids stored under stateKey in the polish-msig-seen key-value store (50,000 ids per key).",
+          "default": false,
+          "prefill": false
+        },
+        "stateKey": {
+          "title": "State key for only-new runs",
+          "type": "string",
+          "editor": "textfield",
+          "isSecret": true,
+          "description": "Key in the seen store when onlyNew is true. Use a unique name per alert task."
+        }
+      }
+    }
   }
-]
+]

package/catalog/tool-descriptions.json

@@ -41,5 +41,14 @@
   },
   "polish-new-companies-krs": {
     "description": "Returns new and changed Polish companies from the official KRS register of entrepreneurs (Krajowy Rejestr Sądowy, rejestr przedsiębiorców) via the Ministry of Justice KRS API: for each KRS number on the daily bulletin in the date window (empty dates mean yesterday, at most 31 days) one item with name, KRS, NIP, REGON, legal form, seat address, main and other PKD codes, share capital, registration and last-entry dates and eventType new or changed. Filter by events, PKD code prefixes, voivodeships, legal forms and minimum share capital; company-level fields only, no personal data such as board members or shareholders. Use it for new-company lead lists, KYC and CRM monitoring; for healthcare providers use polish-healthcare-facilities-rpwdl. Read-only: it only queries the public source and never writes to the registry. Each call needs the APIFY_TOKEN env var and starts one paid run of the Apify Actor enterprising_hamster/polish-new-companies-krs on your Apify account, billed pay-per-event per delivered company plus any Apify platform usage; the server waits up to 300 s for the run and returns JSON {items, truncated} with at most maxItems (max 100) items and 256 KiB."
+  },
+  "polish-company-lookup-regon": {
+    "description": "Looks up Polish companies and other registered subjects by NIP, REGON or KRS number in the official GUS REGON register (Statistics Poland, BIR1.2 API): for each identifier one item with registered name, REGON, NIP, KRS, entity type, legal and ownership form, seat address with TERYT, prevailing and other PKD codes, status (active, suspended, closed) and register dates, optionally VAT taxpayer status from the Ministry of Finance white list (WL2) and nested local units. No phone, fax or email; for sole traders the street is omitted unless soleTraderFullAddress is set. No GUS key is needed (gusApiKey is optional). Use it to identify a known company; for newly registered companies use polish-new-companies-krs. Read-only: it only queries the public source and never writes to the registry. Each call needs the APIFY_TOKEN env var and starts one paid run of the Apify Actor enterprising_hamster/polish-company-lookup-regon on your Apify account, billed pay-per-event per delivered company plus any Apify platform usage; the server waits up to 300 s for the run and returns JSON {items, truncated} with at most maxItems (max 100) items and 256 KiB."
+  },
+  "ukraine-prozorro-tenders": {
+    "description": "Lists Ukraine public tenders from the official Prozorro API for foreign contractors and reconstruction work, with English field names, CPV codes, delivery oblast, value in UAH, status, bid deadline and a link to the tender. Filter by lastDays, onlyOpen, keywords, CPV prefixes, delivery regions and a UAH value range. includeDetails adds the description and is charged at a higher rate. onlyNew with a stateKey is the daily alert of tenders not seen before. It does not cover Poland. Use it for the official Prozorro feed; for Czech, Slovak, Hungarian and Ukrainian tenders in one schema use cee-public-tenders, and for Polish EU-funded notices use polish-eu-funds-tenders-baza-konkurencyjnosci. Read-only: it only queries the public source and never writes to the registry; onlyNew merely keeps a stateKey memory in your own Apify account. Each call needs the APIFY_TOKEN env var and starts one paid run of the Apify Actor enterprising_hamster/ukraine-prozorro-tenders on your Apify account, billed pay-per-event per delivered tender (includeDetails costs more) plus any Apify platform usage; the server waits up to 300 s for the run and returns JSON {items, truncated} with at most maxItems (max 100) items and 256 KiB."
+  },
+  "polish-company-announcements-msig": {
+    "description": "Lists Monitor Sądowy i Gospodarczy (Polish Court and Business Gazette) notices about companies and other legal entities: bankruptcy, restructuring, liquidation, mergers, demergers, transformations, dissolutions and creditor calls, with KRS and court when the notice header has them. Notices about natural persons are never returned. Filter by lastDays (default 1 is today's issue), an inclusive dateFrom and dateTo, announcementKinds, keywords or KRS numbers. fullText is off by default; when on, the notice body can name liquidators, shareholders and other people, so leave it off unless there is a legal basis to store that text. Use it for gazette notices about a company; for newly registered companies use polish-new-companies-krs, and to look up a known NIP, REGON or KRS use polish-company-lookup-regon. Read-only: it only queries the public source and never writes to the registry; onlyNew merely keeps a stateKey memory in your own Apify account. Each call needs the APIFY_TOKEN env var and starts one paid run of the Apify Actor enterprising_hamster/polish-company-announcements-msig on your Apify account, billed pay-per-event per delivered announcement plus any Apify platform usage; the server waits up to 300 s for the run and returns JSON {items, truncated} with at most maxItems (max 100) items and 256 KiB."
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "polish-mcp-servers",
-  "version": "0.1.2",
-  "description": "MCP stdio server for Polish public law and registers. Lists 13 Apify Actor tools without a token and runs them with APIFY_TOKEN.",
+  "version": "0.1.4",
+  "description": "MCP stdio server for Polish public law and registers. Lists 16 Apify Actor tools without a token and runs them with APIFY_TOKEN.",
   "license": "MIT",
   "author": "Kamil Kaczmarek",
   "homepage": "https://github.com/kamilkaczmareksolutions/polish-mcp-servers#readme",
@@ -22,7 +22,12 @@
     "eli",
     "saos",
     "cepik",
-    "krs"
+    "krs",
+    "regon",
+    "nip",
+    "msig",
+    "prozorro",
+    "ukraine"
   ],
   "type": "module",
   "engines": {