# pl-firmy: Polish company check

> pl-firmy: Polish company check is a freemium MCP server for finance and payments. Check Polish contractors against the VAT white list, KRS and VIES before paying. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://api.almmity.com
- **Repository:** https://github.com/mil0s2/pl-firmy-mcp-public
- **MCP Registry name:** com.almmity.api/pl-firmy
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.almmity.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pl-firmy": {
      "url": "https://api.almmity.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [AnalizaFirm.pl - Polish companies (KRS)](https://ai-powered.com/mcp/analizafirm-pl-polish-companies-krs): AnalizaFirm.pl - Polish companies (KRS) is a freemium MCP server for analytics and data.
- [Polish KYB](https://ai-powered.com/mcp/polish-kyb): Polish KYB is a freemium MCP server for legal and government.
- [Karpata – company data from public registers](https://ai-powered.com/mcp/karpata-company-data-from-public-registers): Karpata – company data from public registers is a paid MCP server for finance and payments.
- [tropia.pl: Polish companies (KRS)](https://ai-powered.com/mcp/tropia-pl-polish-companies-krs): tropia.pl: Polish companies (KRS) is a paid MCP server for analytics and data.
- [firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents](https://ai-powered.com/mcp/firmy-ai-polish-company-and-person-registers-krs-ceidg-for-a): firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents is a free MCP server for legal and government.
- [KYB due diligence](https://ai-powered.com/mcp/kyb-due-diligence): KYB due diligence is an MCP server for finance and payments.
- [EU Company Check](https://ai-powered.com/mcp/eu-company-check): EU Company Check is a paid MCP server for legal and government.
- [Nipli — Polish company data](https://ai-powered.com/mcp/nipli-polish-company-data): Nipli — Polish company data is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/pl-firmy-polish-company-check
