pl-firmy-mcp-public

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

## Connect

**Claude Desktop / any stdio client (via mcp-remote)** — see [`examples/claude_desktop_config.json`](examples/claude_desktop_config.json):
```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/`](examples/).
```bash
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](https://api.almmity.com/regulamin) · [Polityka prywatności](https://api.almmity.com/polityka-prywatnosci) · 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](LICENSE). The hosted service itself is proprietary.