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>(orX-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:
{"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/.
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 · [email protected] 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.