skanfirmy-mcp

endpoint

https://skanfirmy.pl/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is skanfirmy-mcp live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is skanfirmy-mcp free to use?

Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.

What tools does skanfirmy-mcp have?

14 tools: oblicz_odsetki, sprawdz_regon, unobserve_nip, changes_since, set_webhook, szukaj_katalog_api, szukaj_pkd, sprawdz_nip, ….

Is skanfirmy-mcp safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• list_observations reads auth-required 4h ago

  Return the list of NIPs you monitor, with their current VAT status and last-checked date (name is null for natural persons running a business). Each entry keeps the raw Ministry of Finance literal in status_vat and, when a status is known, adds derived language-neutral fields vat_active (boolean) and status_vat_code (active/exempt/not_registered). Requires a skanfirmy API key.

  mcp-tool

  12345678910

  {
    "type": "object",
    "required": [],
    "properties": {
      "api_key": {
        "type": "string",
        "description": "skanfirmy API key (optional, if not in the header)."
      }
    }
  }

  arguments 10 lines copy
• oblicz_odsetki reads unknown never probed

  Calculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "required": [
      "kwota",
      "dataOd",
      "dataDo",
      "typ"
    ],
    "properties": {
      "typ": {
        "enum": [
          "kc",
          "h10",
          "h8"
        ],
        "type": "string",
        "description": "kc = statutory late-payment interest (Civil Code art. 481, NBP reference rate + 5.5 pp); h10 = commercial B2B transactions, non-public debtor (NBP reference rate on 1 Jan / 1 Jul + 10 pp); h8 = commercial transactions, public healthcare debtor (NBP reference rate on 1 Jan / 1 Jul + 8 pp)."
      },
      "kwota": {
        "type": "number",
        "description": "Overdue amount in PLN."
      },
      "dataDo": {
        "type": "string",
        "description": "Actual payment date, format YYYY-MM-DD."
      },
      "dataOd": {
        "type": "string",
        "description": "Payment due date, format YYYY-MM-DD."
      }
    }
  }

  arguments 32 lines copy
• sprawdz_regon reads unknown never probed

  Look up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS. For natural persons (GUS type F / LF) and civil partnerships (s.c.) only the NIP, name, entity type code (typ), form (forma: 'osoba fizyczna' / 'jednostka lokalna osoby fizycznej' / 'spółka cywilna'), town and activity status (status: active / ended) are returned — no REGON number, address, administrative units or dates (GDPR); the full entry is in the GUS REGON search (privacy.officialSource).

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "nip"
    ],
    "properties": {
      "nip": {
        "type": "string",
        "description": "10-digit Polish NIP (tax ID)."
      }
    }
  }

  arguments 12 lines copy
• unobserve_nip changes data unknown never probed

  Stop watching a NIP — the watch is deleted right away. Requires a skanfirmy API key.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "nip"
    ],
    "properties": {
      "nip": {
        "type": "string",
        "description": "10-digit NIP to stop watching."
      },
      "api_key": {
        "type": "string",
        "description": "skanfirmy API key (optional, if not in the header)."
      }
    }
  }

  arguments 16 lines copy
• changes_since reads unknown never probed

  Return changes (VAT status, bank accounts, or registry data — name, address, KRS, REGON — from the White List) detected since a given date for the NIPs you monitor. The field property is one of: status_vat, account_added, account_removed, name, address, krs, regon. For natural persons (entities without a KRS number; natural_person: true) only status_vat, account_added and account_removed are returned, account numbers are masked (check digits + last 4, e.g. 61…2874) and name is null (GDPR); check a specific account with sprawdz_rachunek. A polling channel for agents. Requires a skanfirmy API key.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "required": [],
    "properties": {
      "since": {
        "type": "string",
        "description": "ISO date/timestamp (e.g. 2026-08-01). Returns changes since that date. Defaults to the beginning."
      },
      "api_key": {
        "type": "string",
        "description": "skanfirmy API key (optional, if not in the header)."
      }
    }
  }

  arguments 14 lines copy
• set_webhook changes data unknown never probed

  Set (or clear) a push webhook URL for your monitoring, instead of or in addition to polling. When we detect a change for a monitored NIP, we send a POST signed with HMAC-SHA256 (X-Skanfirmy-Signature header). Returns the secret ONCE. Pass an empty url to disable. Requires a skanfirmy API key. Public https addresses only (port 443).

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "required": [],
    "properties": {
      "url": {
        "type": "string",
        "description": "Public https URL of the receiver (empty = disable the webhook)."
      },
      "api_key": {
        "type": "string",
        "description": "skanfirmy API key (optional, if not in the header)."
      }
    }
  }

  arguments 14 lines copy
• szukaj_katalog_api reads unknown never probed

  Search otwarteAPI.pl, a catalog of public Polish and EU APIs (VAT, KRS, GUS, NBP, ECB, Eurostat and more). Returns matching entries with a link to each API's official docs. An empty query returns the whole catalog (optionally narrowed by scope or topic).

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [],
    "properties": {
      "temat": {
        "type": "string",
        "description": "Narrow to a specific catalog tag, e.g. \"firmy\" or \"dane-statystyczne\". Optional."
      },
      "zasieg": {
        "enum": [
          "PL",
          "EU"
        ],
        "type": "string",
        "description": "Narrow to Polish (PL) or EU APIs. Optional."
      },
      "zapytanie": {
        "type": "string",
        "description": "Natural-language query, e.g. \"euro exchange rate\" or \"weather data\". Optional."
      }
    }
  }

  arguments 22 lines copy
• szukaj_pkd reads unknown never probed

  Search PKD 2025 business activity codes by activity name or code number.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "zapytanie"
    ],
    "properties": {
      "zapytanie": {
        "type": "string",
        "description": "Activity name (e.g. \"software\") or PKD code (e.g. \"62.01\")."
      }
    }
  }

  arguments 12 lines copy
• sprawdz_nip reads unknown never probed

  Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP. For entities without a KRS number (sole proprietors and civil partnerships, i.e. natural persons) personal data is limited (GDPR): the address is reduced to the town (the White List does not say whether it is a business or a home address), and bank accounts to their count — check a specific account with sprawdz_rachunek; no REGON number, registration date or PKD codes are returned for them (the ceidg field is always null). The privacy field lists what was hidden. White List data for entities with a KRS number may come from a same-day cache: then mfCached is true and bl.mfRequestDateTime is the time of the original Ministry query. If the full White List refuses the query (Ministry limit), the result may be status-only (source: status-only): bl is null and vatStatus has only the VAT status from the Ministry's API2, without name, address or bank accounts.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "nip"
    ],
    "properties": {
      "nip": {
        "type": "string",
        "description": "10-digit Polish NIP (tax ID)."
      }
    }
  }

  arguments 12 lines copy
• sprawdz_rachunek reads unknown never probed

  Check whether a bank account number (NRB) appears in the VAT White List for a given NIP. Due diligence for payments above PLN 15,000.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "nip",
      "numerRachunku"
    ],
    "properties": {
      "nip": {
        "type": "string",
        "description": "10-digit NIP of the counterparty."
      },
      "numerRachunku": {
        "type": "string",
        "description": "26-digit bank account number (NRB), without the PL prefix."
      }
    }
  }

  arguments 17 lines copy
• observe_nip changes data unknown never probed

  Add a NIP to monitoring. You get notified (via changes_since or email) when its VAT status, bank account, or registry data shown on the Ministry of Finance White List (name, address, KRS, REGON) changes. For natural persons running a business (entities without a KRS number) only the VAT status and masked bank accounts are monitored (GDPR): no name, address or REGON changes. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "nip"
    ],
    "properties": {
      "nip": {
        "type": "string",
        "description": "10-digit NIP to monitor."
      },
      "api_key": {
        "type": "string",
        "description": "skanfirmy API key (if not provided in the Authorization header)."
      }
    }
  }

  arguments 16 lines copy
• sprawdz_lista_nip reads unknown never probed

  Bulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS number and address of each entity. For entities without a KRS number (natural persons) the address is reduced to the town and bank accounts to their count, and no REGON number or registration date is returned (GDPR) — check a specific account with sprawdz_rachunek. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call; the Ministry's daily query limit is shared by the whole service — when it is exhausted, the tool returns an error. Does not fetch full KRS data (use sprawdz_nip for individual entities). If every NIP in the list is an entity with a KRS number already checked today, the result comes from a same-day cache without a Ministry query: mfCached is true and mfRequestDateTime is the time of the oldest of those queries.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "nipy"
    ],
    "properties": {
      "nipy": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 30,
        "minItems": 1,
        "description": "List of NIPs (1 to 30). Each 10-digit with a valid checksum. Invalid NIPs are returned separately in the invalidInput field."
      }
    }
  }

  arguments 17 lines copy
• sprawdz_vies reads unknown never probed

  Validate a counterparty's EU VAT number in the VIES system (European Commission). For Polish (PL) numbers the address is reduced to the town, because the number may belong to a natural person (GDPR).

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647

  {
    "type": "object",
    "required": [
      "countryCode",
      "vatNumber"
    ],
    "properties": {
      "vatNumber": {
        "type": "string",
        "description": "VAT number without the country prefix."
      },
      "countryCode": {
        "enum": [
          "AT",
          "BE",
          "BG",
          "CY",
          "CZ",
          "DE",
          "DK",
          "EE",
          "EL",
          "ES",
          "FI",
          "FR",
          "HR",
          "HU",
          "IE",
          "IT",
          "LT",
          "LU",
          "LV",
          "MT",
          "NL",
          "PL",
          "PT",
          "RO",
          "SE",
          "SI",
          "SK",
          "XI"
        ],
        "type": "string",
        "description": "Two-letter EU country code (e.g. DE, IE, FR)."
      }
    }
  }

  arguments 47 lines copy
• generuj_mikrorachunek reads unknown never probed

  Generate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP. The server does not accept PESEL (personal ID) — for a PESEL compute it locally: BBAN = "101000712221" + PESEL + "0", IBAN = "PL" + ISO 7064 mod-97 check digits + BBAN (or use skanfirmy.pl/mikrorachunek, which computes it in the browser).

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "identyfikator"
    ],
    "properties": {
      "identyfikator": {
        "type": "string",
        "description": "NIP (10 digits). PESEL is not accepted by the server."
      }
    }
  }

  arguments 12 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.