# skanfirmy.pl (remote · skanfirmy.pl)

Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key).

- Trust score: 75/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- remote · `skanfirmy.pl`: 75/100 (this document), [markdown](https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy.md), [page](https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy)

## Channel facts

- Endpoint: `https://skanfirmy.pl/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 14 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 79/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1581 tokens (~112/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 90/100
  - Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "unobserve_nip" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the skanfirmy.pl MCP server?

skanfirmy.pl is a hosted endpoint at https://skanfirmy.pl/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http bartosz-kuc-skanfirmy 'https://skanfirmy.pl/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "bartosz-kuc-skanfirmy": {
      "url": "https://skanfirmy.pl/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "bartosz-kuc-skanfirmy": {
      "type": "http",
      "url": "https://skanfirmy.pl/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.bartosz-kuc-skanfirmy]
url = "https://skanfirmy.pl/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bartosz-kuc-skanfirmy": {
      "type": "remote",
      "url": "https://skanfirmy.pl/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add bartosz-kuc-skanfirmy --url 'https://skanfirmy.pl/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  bartosz-kuc-skanfirmy:
    url: "https://skanfirmy.pl/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "bartosz-kuc-skanfirmy": {
      "Transport": "http",
      "Url": "https://skanfirmy.pl/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add bartosz-kuc-skanfirmy -t streamable-http -u 'https://skanfirmy.pl/mcp'
```

### Other

```json
{
  "mcpServers": {
    "bartosz-kuc-skanfirmy": {
      "type": "http",
      "url": "https://skanfirmy.pl/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-21 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-19 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-18 (score 73, 0)

- [functional] Server version: 1.1.1 → 1.1.2

### 2026-09-17 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-15 (score 72, +1)

- [functional] Server version: 1.0.0 → 1.1.1

### 2026-09-13 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-08 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (14)

### `sprawdz_nip` (~50 tokens)

Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.

Input parameters:

- `nip` (string, required): 10-digit Polish NIP (tax ID).

### `sprawdz_lista_nip` (~131 tokens)

Bulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS and address of each entity. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call, about 500 bulk queries/day per IP. Does not fetch full KRS data (use sprawdz_nip for individual entities).

Input parameters:

- `nipy` (array, required): List of NIPs (1 to 30). Each 10-digit with a valid checksum. Invalid NIPs are returned separately in the invalidInput field.

### `sprawdz_regon` (~91 tokens)

Look up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), full address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS.

Input parameters:

- `nip` (string, required): 10-digit Polish NIP (tax ID).

### `sprawdz_vies` (~63 tokens)

Validate a counterparty's EU VAT number in the VIES system (European Commission).

Input parameters:

- `countryCode` (string, required): Two-letter EU country code (e.g. DE, IE, FR).
- `vatNumber` (string, required): VAT number without the country prefix.

### `sprawdz_rachunek` (~84 tokens)

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.

Input parameters:

- `nip` (string, required): 10-digit NIP of the counterparty.
- `numerRachunku` (string, required): 26-digit bank account number (NRB), without the PL prefix.

### `generuj_mikrorachunek` (~58 tokens)

Generate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP or PESEL.

Input parameters:

- `identyfikator` (string, required): NIP (10 digits) or PESEL (11 digits).

### `szukaj_pkd` (~57 tokens)

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

Input parameters:

- `zapytanie` (string, required): Activity name (e.g. "software") or PKD code (e.g. "62.01").

### `oblicz_odsetki` (~167 tokens)

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

Input parameters:

- `dataDo` (string, required): Actual payment date, format YYYY-MM-DD.
- `dataOd` (string, required): Payment due date, format YYYY-MM-DD.
- `kwota` (number, required): Overdue amount in PLN.
- `typ` (string, required): 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 = comme…

### `szukaj_katalog_api` (~151 tokens)

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

Input parameters:

- `temat` (string): Narrow to a specific catalog tag, e.g. "firmy" or "dane-statystyczne". Optional.
- `zapytanie` (string): Natural-language query, e.g. "euro exchange rate" or "weather data". Optional.
- `zasieg` (string): Narrow to Polish (PL) or EU APIs. Optional.

### `observe_nip` (~124 tokens)

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. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.

Input parameters:

- `api_key` (string): skanfirmy API key (if not provided in the Authorization header).
- `nip` (string, required): 10-digit NIP to monitor.

### `unobserve_nip` (~64 tokens)

Remove a NIP from monitoring. Requires a skanfirmy API key.

Input parameters:

- `api_key` (string): skanfirmy API key (optional, if not in the header).
- `nip` (string, required): 10-digit NIP to remove from monitoring.

### `list_observations` (~104 tokens)

Return the list of NIPs you monitor, with their current VAT status and last-checked date. 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.

Input parameters:

- `api_key` (string): skanfirmy API key (optional, if not in the header).

### `changes_since` (~145 tokens)

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. A polling channel for agents. Requires a skanfirmy API key.

Input parameters:

- `api_key` (string): skanfirmy API key (optional, if not in the header).
- `since` (string): ISO date/timestamp (e.g. 2026-08-01). Returns changes since that date. Defaults to the beginning.

### `set_webhook` (~135 tokens)

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

Input parameters:

- `api_key` (string): skanfirmy API key (optional, if not in the header).
- `url` (string): Public https URL of the receiver (empty = disable the webhook).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy#diagnostics

## Score history

- 2026-09-21: 75
- 2026-09-20: 74
- 2026-09-19: 74
- 2026-09-18: 73
- 2026-09-17: 73
- 2026-09-16: 72
- 2026-09-15: 72
- 2026-09-14: 71
- 2026-09-13: 71
- 2026-09-12: 70
- 2026-09-11: 70
- 2026-09-10: 69
- 2026-09-09: 69
- 2026-09-08: 69
- 2026-09-07: 68
- 2026-09-06: 68
- 2026-09-05: 67
- 2026-09-04: 67
- 2026-09-03: 66
- 2026-09-02: 66
- 2026-09-01: 65
- 2026-08-31: 65
- 2026-08-30: 64
- 2026-08-29: 64
- 2026-08-28: 63
- 2026-08-27: 63
- 2026-08-26: 63
- 2026-08-25: 62

## Common questions

### What is the skanfirmy.pl MCP server?

skanfirmy.pl is an MCP server listed in the public MCP registry as io.github.bartosz-kuc/skanfirmy. Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key). This page covers its hosted endpoint (https://skanfirmy.pl/mcp).

### Is the skanfirmy.pl MCP server safe to use?

skanfirmy.pl scores 75 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the skanfirmy.pl MCP server expose?

skanfirmy.pl exposes 14 tools: sprawdz_nip, sprawdz_lista_nip, sprawdz_regon, sprawdz_vies, sprawdz_rachunek, and 9 more. Their descriptions and schemas cost roughly 1,424 tokens of context every time the server is loaded.

### Does the skanfirmy.pl MCP server require authentication?

No. We connected to skanfirmy.pl without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the skanfirmy.pl MCP server still maintained?

skanfirmy.pl is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://skanfirmy.pl/mcp
- Repository: https://github.com/bartosz-kuc/skanfirmy-mcp
- Changelog RSS feed: https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy.xml
- Changelog JSON feed: https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy.json
- HTML version of this page: https://verifymcp.io/servers/bartosz-kuc-skanfirmy/skanfirmy