English Français العربية

pl-firmy: Polish company check

Official registry Productivity

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http pl-firmy-polish-company-check 'https://api.almmity.com/mcp' --header 'Authorization: <Bearer API key. Free key: https://api.almmity.com/#klucz>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pl-firmy-polish-company-check": {
            "type": "http",
            "url": "https://api.almmity.com/mcp",
            "headers": {
                "Authorization": "<Bearer API key. Free key: https://api.almmity.com/#klucz>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pl-firmy — MCP server for checking Polish companies
  2. Tools
  3. Connect
  4. Example prompts
  5. Data sources & limits
  6. Privacy & terms
  7. pl-firmy — serwer MCP do weryfikacji polskich firm (PL)
  8. License

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 <API key> (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 <klucz> — 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.

Frequently asked questions

What is pl-firmy: Polish company check?

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

How do I install pl-firmy: Polish company check?

It runs as a remote server. In Claude Code: claude mcp add --transport http pl-firmy-polish-company-check 'https://api.almmity.com/mcp' --header 'Authorization: <Bearer API key. Free key: https://api.almmity.com/#klucz>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does pl-firmy: Polish company check need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is pl-firmy: Polish company check open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains pl-firmy: Polish company check?

It is published by mil0s2. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.