pl-firmy: Polish company check
Verify Polish companies: VAT white list (MF), KRS, VIES, payment audit PDF, monitoring.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"pl-firmy": {
"url": "https://api.almmity.com/mcp"
}
}
}Remote endpoints
https://api.almmity.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟡add_watch(nip, accounts, label, webhook_url, email)
Start daily monitoring of a Polish contractor: VAT status changes, whitelisted bank accounts added/removed (incl. the specific accounts you pay to), KRS liquidation/bankruptcy/restructuring. Alerts via webhook and/or e-mail. Re-adding updates the watch.
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bank accounts you pay this contractor to"
},
"label": {
"type": "string"
},
"webhook_url": {
"type": "string",
"format": "uri"
},
"email": {
"type": "string",
"format": "email"
}
},
"required": [
"nip"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_watches
List your monitored contractors with last status and recent change events.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴remove_watch(nip)
Remove a contractor (by NIP) from monitoring.
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
}
},
"required": [
"nip"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢payment_audit_report(nip, account, amount, currency, invoice, ...)
Before paying a Polish contractor: verify NIP + bank account on the MF white list for the payment date, check KRS and VIES, and produce a PDF 'proof of due diligence' (MF request IDs, timestamps, findings, SHA-256). Flags the >15 000 PLN rule (art. 117ba OP, MPP).
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
},
"account": {
"type": "string"
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3
},
"invoice": {
"type": "string",
"description": "Invoice number"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD, default today (Europe/Warsaw). MF allows up to 5 years back."
}
},
"required": [
"nip",
"account"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_vat_whitelist(nip, regon, bank_account, date)
Query the Ministry of Finance VAT white list. Give nip (and optionally bank_account to verify the account belongs to that NIP on a date), or regon, or bank_account alone to find who owns it.
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
},
"regon": {
"type": "string"
},
"bank_account": {
"type": "string",
"description": "26-digit NRB / PL IBAN"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD, default today (Europe/Warsaw). MF allows up to 5 years back."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_krs_extract(krs)
Current KRS (National Court Register) extract: name, legal form, address, share capital, board & representation, proxies, PKD codes, liquidation/bankruptcy flags.
Input Schema
{
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS number, e.g. 0000028860"
}
},
"required": [
"krs"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢find_company(nip, regon, krs)
Combine MF white list + KRS into one normalized company profile. Provide one of nip, regon, krs.
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
},
"regon": {
"type": "string"
},
"krs": {
"type": "string"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢vies_check(eu_vat)
Validate an EU VAT number via the European Commission VIES REST API, e.g. PL7740001454, DE811569869.
Input Schema
{
"type": "object",
"properties": {
"eu_vat": {
"type": "string"
}
},
"required": [
"eu_vat"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contractor_due_diligence(nip, bank_account)
Concise risk summary for a Polish contractor by NIP: VAT status, whitelisted accounts (optionally verify a given bank account), KRS liquidation/bankruptcy/restructuring flags.
Input Schema
{
"type": "object",
"properties": {
"nip": {
"type": "string"
},
"bank_account": {
"type": "string"
}
},
"required": [
"nip"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence