Skip to content
MCP server

pl-firmy: Polish company check

Check Polish contractors against the VAT white list, KRS and VIES before paying

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
0.3.1
Listing updated
4 days ago

Similar MCP servers

About pl-firmy: Polish company check

pl-firmy: Polish company check is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

pl-firmy exists for one Polish accounting habit: confirming that a supplier's bank account is on the Ministry of Finance VAT white list before sending a transfer. It queries the white list, the KRS court register and EU VIES live and combines them into a verdict.

The README's tools include check_vat_whitelist, get_krs_extract, find_company by NIP, REGON or KRS, vies_check and contractor_due_diligence, which returns OK, WARN or STOP. payment_audit_report produces a PDF recording the check, with SHA-256 checksum and Ministry query IDs, useful for invoices above 15,000 zloty. add_watch, list_watches and remove_watch set up daily monitoring with e-mail or HMAC-signed webhook alerts when VAT status or accounts change.

Tool discovery works without a key; calls need one. The operator says it is not affiliated with the Ministry of Finance or Justice and results are informational.

Install

Run in a terminal

claude mcp add --transport http pl-firmy https://api.almmity.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.almmity.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pl-firmy": {
      "url": "https://api.almmity.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pl-firmy": {
      "serverUrl": "https://api.almmity.com/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://api.almmity.com/mcp

Enter a Name (for example "pl-firmy: Polish company check"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pl-firmy": {
      "type": "http",
      "url": "https://api.almmity.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

check_vat_whitelist
Checks VAT status and registered bank accounts on the MF white list.
get_krs_extract
Returns the current KRS extract.
find_company
Finds a company by NIP, REGON or KRS number.
vies_check
Validates an EU VAT number via VIES.
contractor_due_diligence
Checks all sources with an OK, WARN or STOP summary.
payment_audit_report
Creates a PDF report documenting the payment check.
add_watch
Adds a contractor to daily monitoring.
list_watches
Lists monitored contractors.
remove_watch
Removes a contractor from monitoring.

What it does

White list check
Confirms VAT status and whether an account belongs to a NIP.
KRS extract
Legal form, board, capital and address.
VIES validation
Checks EU VAT numbers.
Due diligence verdict
OK, WARN or STOP across all sources.
Payment audit PDF
Documented check with checksum.
Daily monitoring
Alerts by e-mail or webhook.

Good for

  • Verify a supplier's account before a large transfer
  • Produce proof for payment documentation
  • Monitor contractors for liquidation or VAT removal
  • Validate an EU VAT number

Pricing

Freemium

Free 100 checks/month; Pro 59 zl/mo, Biuro 199 zl/mo net

Prices change. Check api.almmity.com before you buy.

pl-firmy: Polish company check FAQ

Is there a free plan?

Yes, 100 checks a month and 3 monitored contractors.

What do paid plans cost?

Pro is 59 zloty a month net for 10,000 checks; Biuro is 199 zloty net for 50,000.

Does it need a key?

Yes for tool calls; discovery works without one.

Is it official?

No, it is not affiliated with government bodies.

Is pl-firmy: Polish company check free?

pl-firmy: Polish company check has a free plan, with paid plans for more usage or features.

How do I add pl-firmy: Polish company check to Claude Code?

Run this command in your terminal: claude mcp add --transport http pl-firmy https://api.almmity.com/mcp

What are the best alternatives to pl-firmy: Polish company check?

The closest alternatives to pl-firmy: Polish company check are AnalizaFirm.pl - Polish companies (KRS), Polish KYB, Karpata – company data from public registers, tropia.pl: Polish companies (KRS) and firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers