Skip to main content
Glama

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

Tool

What it does

check_vat_whitelist

MF VAT white list (Biała lista): VAT status, registered bank accounts, optional check that a given account belongs to the NIP

get_krs_extract

Current KRS extract: legal form, board/representation, capital, address

find_company

Find a company by NIP, REGON or KRS number

vies_check

EU VIES VAT number validation

contractor_due_diligence

One-shot check of all sources with a risk summary (OK / WARN / STOP)

payment_audit_report

PDF report proving the payment check (art. 117ba Ordynacji podatkowej / split payment due diligence)

add_watch / list_watches / remove_watch

Daily monitoring of contractors with e-mail/webhook alerts on status or bank-account changes

Related MCP server: Polish Business Intelligence MCP

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Look up Polish companies from any AI assistant: registry data (KRS, REGON, CEIDG), VAT white list checks before payments, and financial statements of 4.4M businesses. Read-only tools backed by official public registers.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to access official European business data across 15 EU countries, including company lookups, VAT validation, sanctions screening, and KYB reports.
      8,811 npm
      1
      MIT