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:

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

Terminal

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.