Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

pl-firmy: Polish company check

by mil0s2version 0.3.1i★ –iRuns in the cloud
Registry namecom.almmity.api/pl-firmy

Install

Overview

Description from the maker (original English)

Verify Polish companies: VAT white list (MF), KRS, VIES, payment audit PDF, monitoring.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Online shops & payments
  • You need to fill in: Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http pl-firmy https://api.almmity.com/mcp --header 'Authorization: Bearer {api_key}'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "pl-firmy": {
      "url": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "pl-firmy": {
      "type": "http",
      "url": "https://api.almmity.com/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • Authorization secret required HTTP header
    Bearer API key. Free key: https://api.almmity.com/#klucz

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 8, 2026. The maker wrote them, not us; we show them as plain text.

  • add_watch

    Once a day, check one Polish contractor (one NIP) in public registries. The check reads VAT status and white-list bank accounts from the Ministry of Finance, and reads KRS for liquidation, bankruptcy or restructuring. It stores the NIP, any bank accounts you choose to watch, an o

  • list_watches

    List contractors monitored for your account, with the last stored status and recent change events. Reads only this server's database. Requires sign-in (OAuth) or an almmity API key.

  • remove_watch

    Remove one contractor, identified by NIP, from monitoring for your account. Deletes the watch and stops future alerts. Requires sign-in (OAuth) or an almmity API key.

  • payment_audit_report

    Before paying a Polish contractor, verify the NIP and bank account on the MF VAT white list for the payment date, check KRS and VIES, and store a PDF proof of due diligence (MF request IDs, timestamps, findings, SHA-256). Flags the 15 000 PLN rule (art. 117ba of the Tax Ordinance

  • check_vat_whitelist

    Query the Ministry of Finance VAT white list (wl-api.mf.gov.pl). Returns the full taxpayer card: name, NIP, VAT status, REGON, KRS, address, every account (groups of 4), registration/denial/removal/restoration dates with legal basis, representatives, authorized clerks, partners,

  • get_krs_extract

    Current KRS (National Court Register) extract: name, legal form, address, share capital, board and representation, proxies, PKD codes, liquidation and bankruptcy flags. Reads a public registry and does not change it. Callable without an API key, within the daily per-IP limit.

  • find_company

    Combine the MF VAT white list and KRS into one normalized company profile. Provide one of nip, regon or krs. Reads public registries and does not change them. Callable without an API key, within the daily per-IP limit.

  • vies_check

    Validate an EU VAT number via the European Commission VIES REST API, for example PL7740001454 or DE811569869. Reads a public registry and does not change it. Callable without an API key, within the daily per-IP limit.

  • contractor_due_diligence

    Concise risk summary for a Polish contractor by NIP: VAT status, whitelisted accounts (optionally verify one bank account), and KRS liquidation, bankruptcy or restructuring flags. Reads public registries and does not change them. Callable without an API key, within the daily per-

  • validate_ksef_xml

    Validate a KSeF FA(3) invoice XML against the official Ministry of Finance schema (when xmllint and the vendored XSD are available) and against business rules: NIP checksum, totals, bank account checksum, required JST/GV, correction references. Returns Polish error messages. Does

  • generate_fa3_xml

    Build a sales invoice XML in the FA(3) schema (kodSystemowy FA (3), variant 3) from seller, buyer and line items. Header VAT is computed from the summed net base of each rate. Does not send the invoice to KSeF and does not store it. Callable without an API key.

  • generate_correction_xml

    Build an FA(3) correction invoice (RodzajFaktury KOR). Header amounts are the difference versus the original. Pass beforeLines to emit state-before (StanPrzed) and state-after rows; otherwise lines are the delta. Does not send the invoice to KSeF. Callable without an API key.

  • summarize_ksef_invoice

    Parse an FA(3) XML into a short Polish summary: parties, dates, net, VAT, gross, split payment, due date and bank account. Returns a link to the XML-to-PDF viewer. It creates a temporary PDF file on api.almmity.com, reachable by an unguessable link for one hour, then deleted. Not

  • build_transfer_title

    Build a Polish bank transfer title that carries one KSeF invoice number or a collective identifier (art. 108g VAT). mode=mpp builds the split-payment message /VAT/IDC/INV/TXT and checks the supplier NIP checksum. Does not send a payment. Callable without an API key.

  • calculate_late_interest

    Calculate Polish late-payment interest with the same rates and day count as ksef.almmity.com: commercial (NBP reference + 10 pp), medical public debtor (+ 8 pp) or statutory (reference + 5.5 pp), plus the 40/70/100 EUR compensation converted at the NBP euro rate. Returns the segm

  • draft_payment_demand

    Draft a Polish pre-court payment demand (wezwanie do zapłaty) from the same interest calculation as calculate_late_interest, including art. 187 of the Code of Civil Procedure. Returns the text. It creates a temporary PDF file on api.almmity.com, reachable by an unguessable link f

  • nip_checksum

    Check the checksum of a Polish NIP (weights 6,5,7,2,3,4,5,6,7). Local arithmetic only. Callable without an API key. Does not look the NIP up in any registry.

  • list_cost_invoices

    List cost invoices already stored on the linked KSeF Płatności account: number, seller, amounts, due date, payment status and white-list check. Requires OAuth scope invoices.read. Never ask the user for a KSeF token or a password. Does not download new invoices from KSeF.

  • unpaid_due_soon

    List unpaid cost invoices on the linked KSeF Płatności account that are overdue or due within withinDays (default 7, max 90). Requires OAuth scope invoices.read. Never ask for a KSeF token or a password.

  • export_transfer_batch

    Prepare an Elixir-0 transfer file for selected cost invoices on the linked KSeF Płatności account. Each account is re-checked on the MF white list for today; unsafe lines are left out of the file. Requires OAuth scope transfers.prepare. The file is not sent to a bank. Never ask f

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

  • ! Caution

    Maker matches the repo

    The publisher (api.almmity.com) is not the repo owner (mil0s2); someone else may have listed it

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 636 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 20 tool descriptions and found no hidden instructions to the AI

Compared with others in Online shops & paymentsi

  • More stars than 0% of the other 2593 servers in this category
  • Published to the registry more recently than 51% of the other 2593 servers in this category
  • Basic checks equal to or better than 53% of the other 2593 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is pl-firmy: Polish company check safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.3.1) reached the registry 28 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2KUpdated 13 months ago

Runs in the cloud✓ stripe.com

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

by TonyWang-hubEarly↓ 73/wk★ 96Updated 30 days ago

Runs on your computer

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

pl-firmy — MCP server for checking Polish companies

Hosted remote MCP server that gives AI assistants verified data on Polish contractors straight from official registries: MF Biała lista podatników VAT, KRS, and EU VIES — plus a payment audit PDF and daily contractor monitoring.

  • Endpoint (Streamable HTTP): https://api.almmity.com/mcp
  • Auth: Authorization: Bearer (or X-API-Key). Free key (100 calls/month): https://api.almmity.com/#klucz
  • Tool discovery (initialize, tools/list) works without a key; tool calls need one.
  • Plans: Free 0 zł · Pro 59 zł/mies. · Biuro 199 zł/mies. — https://api.almmity.com/#cennik

Tools

ToolWhat it does
check_vat_whitelistMF VAT white list (Biała lista): VAT status, registered bank accounts, optional check that a given account belongs to the NIP
get_krs_extractCurrent KRS extract: legal form, board/representation, capital, address
find_companyFind a company by NIP, REGON or KRS number
vies_checkEU VIES VAT number validation
contractor_due_diligenceOne-shot check of all sources with a risk summary (OK / WARN / STOP)
payment_audit_reportPDF report proving the payment check (art. 117ba Ordynacji podatkowej / split payment due diligence)
add_watch / list_watches / remove_watchDaily monitoring of contractors with e-mail/webhook alerts on status or bank-account changes

Connect

Claude Desktop / any stdio client (via mcp-remote) — see examples/claude_desktop_config.json:

{"mcpServers":{"pl-firmy":{"command":"npx","args":["-y","mcp-remote","https://api.almmity.com/mcp","--header","Authorization: Bearer ${PLF_API_KEY}"],"env":{"PLF_API_KEY":"plf_..."}}}}

Cursor (~/.cursor/mcp.json), VS Code, Claude Code: see examples/.

claude mcp add --transport http pl-firmy https://api.almmity.com/mcp --header "Authorization: Bearer plf_..."

Example prompts

  • "Sprawdź NIP 7740001454 przed przelewem na konto PL.. i zrób raport PDF."
  • "Is Polish VAT number PL7740001454 valid in VIES, and who represents the company in KRS?"
  • "Monitoruj tych 20 kontrahentów i powiadom mnie, gdy któryś zniknie z białej listy."

Data sources & limits

Data is fetched live from public government APIs (wl-api.mf.gov.pl, api-krs.ms.gov.pl, ec.europa.eu VIES) and cached briefly. The service is not affiliated with the Ministry of Finance or the Ministry of Justice. Results are informational; the PDF report documents the check at a given time.

Privacy & terms

Regulamin · Polityka prywatności · contact@almmity.com Operator: MMIT Miłosz Mazurkiewicz, NIP 8883151717.


pl-firmy — serwer MCP do weryfikacji polskich firm (PL)

Zdalny serwer MCP, który daje asystentom AI (Claude, ChatGPT, Cursor, n8n) sprawdzone dane o kontrahentach prosto z rejestrów: Biała lista VAT (MF), KRS, VIES. Do tego raport PDF z weryfikacji przed płatnością i codzienny monitoring kontrahentów z alertem e-mail/webhook.

  • Adres: https://api.almmity.com/mcp (Streamable HTTP)
  • Klucz API: nagłówek Authorization: Bearer — darmowy klucz (100 zapytań/mies.): https://api.almmity.com/#klucz
  • Cennik: Free 0 zł · Pro 59 zł/mies. (10 000 zapytań, 500 monitorowanych) · Biuro 199 zł/mies. (50 000 zapytań, 2 000 monitorowanych, eksport CSV)

Dla kogo: biura rachunkowe, działy finansowe, automatyzacje płatności — weryfikacja rachunku na białej liście przed przelewem powyżej 15 000 zł (art. 117ba Ordynacji podatkowej, art. 15d ustawy o CIT / 22p PIT).

License

Documentation and examples in this repository: MIT. The hosted service itself is proprietary.

Ask PopNx