# pl-firmy: Polish company check [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/mil0s2/pl-firmy-mcp-public  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pl-firmy-polish-company-check

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

## Tools
Capabilities this server exposes over MCP:

- **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** — Daily monitoring of contractors with e-mail/webhook alerts on status or bank-account changes

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

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

## Documentation

## What pl-firmy: Polish company check does

pl-firmy: Polish company check exposes company-verification workflows through MCP for AI assistants and other MCP clients. Its data sources are public government services: the Polish Ministry of Finance VAT white list, the National Court Register (KRS), and the European Commission VIES service.

The server is intended for checks on Polish contractors and payment preparation. You can look up a company using its NIP, REGON, or KRS number; inspect KRS registration details; validate a European VAT number; and check whether a bank account appears on the MF VAT white list for a given NIP. A combined due-diligence operation returns a risk summary using the statuses OK, WARN, or STOP.

## How it works

The service is hosted remotely and accepts MCP requests through Streamable HTTP at `https://api.almmity.com/mcp`. Discovery requests such as `initialize` and `tools/list` work without authentication, but invoking tools requires an API key. Send the key as `Authorization: Bearer <API key>` or with the `X-API-Key` header.

When a check runs, the service fetches live data from the configured public APIs and may cache it briefly. The payment-audit tool creates a PDF documenting the result of a check at a particular time. That document can support payment due diligence relating to article 117ba of the Polish Tax Ordinance and split-payment processes, but the service describes results as informational rather than as a guarantee of legal compliance.

## Setup and configuration

Connect an MCP client directly to the Streamable HTTP endpoint with the required authorization header. Claude Desktop can use `mcp-remote` as a stdio bridge; the repository also provides connection examples for Cursor, VS Code, and Claude Code. A typical remote connection needs the endpoint and an API key such as `plf_...`.

A free API key is available from the service website and includes 100 calls per month. The listed paid plans provide higher call and monitoring limits. Keep the key outside prompts and source files, and expose it to a local `mcp-remote` configuration through an environment variable such as `PLF_API_KEY`.

## Tools and capabilities

- `check_vat_whitelist` checks VAT status and registered bank accounts in the MF white list. It can also test whether a supplied account belongs to the specified NIP.
- `get_krs_extract` returns current KRS information including legal form, company address, capital, and board or representation details.
- `find_company` searches by NIP, REGON, or KRS number.
- `vies_check` validates an EU VAT number through VIES.
- `contractor_due_diligence` combines the available checks and produces an OK, WARN, or STOP risk summary.
- `payment_audit_report` produces a PDF record of a payment check.
- `add_watch`, `list_watches`, and `remove_watch` manage daily contractor monitoring. Alerts can be sent by email or webhook when a monitored status or bank account changes.

## Limitations and notes

The server is not affiliated with the Polish Ministry of Finance or Ministry of Justice. Its information comes from public APIs and can be briefly cached, so a result represents the state observed at the time of the request. The payment PDF documents that check at a given time; it should not be treated as an unconditional legal conclusion.

The hosted service is proprietary even though the repository documentation and examples are licensed under MIT. The service publishes terms and a privacy policy, and its pricing and quotas may differ by plan. pl-firmy: Polish company check is most suitable when an agent needs structured access to these named registries and payment-monitoring functions, rather than a general company-data search across unspecified sources.

_Full upstream README: https://allmcps.com/mcp/pl-firmy-polish-company-check/readme_