# biala-lista

biala-lista is a Claude Code skill that checks Polish companies and VAT status by NIP or REGON. It runs on requests to verify a contractor, bank account, or Polish invoice.

- skill · `type=skill` · Claude Code, Gemini CLI, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Claude.ai · ★ 60 repo stars
- Author: Michell Hoduń (https://github.com/b44x)
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/b44x/ai-polish-skills/tree/HEAD/skills/biala-lista/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/biala-lista

## What it does

The skill queries Poland’s Ministry of Finance registry and returns company and VAT data as JSON. Look up a business by NIP or REGON to retrieve its legal name, address, KRS, and settlement accounts. It can also find a company by bank account, compare an account with a NIP, and validate NIP, REGON, or NRB checksums offline.

The skill runs `scripts/biala_lista.py`. It requires Python 3.8+ and network access to `wl-api.mf.gov.pl`; it uses no external libraries and needs no authentication. Add `--date=YYYY-MM-DD` to check a past date. The API limit is 300 requests per day per IP.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add b44x/ai-polish-skills
```
In the agent chat (not a shell):
```text
/plugin install biala-lista@polskie-skille
```
This installs the whole biala-lista plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add b44x/ai-polish-skills --skill biala-lista -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/biala-lista/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/biala-lista/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add b44x/ai-polish-skills --skill biala-lista -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/biala-lista/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add b44x/ai-polish-skills --skill biala-lista -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/biala-lista/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b44x/ai-polish-skills skills/biala-lista
```

2. **Manually: put the files in place**
- File: `.github/skills/biala-lista/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add b44x/ai-polish-skills --skill biala-lista -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/biala-lista
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/biala-lista/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/b44x/ai-polish-skills/tree/HEAD/skills/biala-lista/SKILL.md

## When to use it
- check a Polish company’s VAT status by NIP
- find a business by REGON or bank account
- match a contractor’s account to its NIP
- validate a NIP, REGON, or NRB checksum offline

## Example prompts
- Check the VAT status and settlement accounts for the Polish company with NIP `5260250274`.
- Check whether account `PL61109010140000071219812874` is listed for NIP `5260250274`.
- Validate this REGON checksum without querying the API: `123456789`.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 48f9fbd328d95bb1.

BEGIN THIRD-PARTY FILE 48f9fbd328d95bb1
```text
---
name: biala-lista
display_name: Biała Lista Podatników VAT
version: 1.0.0
description: >-
  Check Polish businesses and VAT status in the official Ministry of Finance White
  List (Biała Lista Podatników VAT). Verify active VAT payer status (Czynny /
  Zwolniony / Niezarejestrowany), legal company name, REGON, KRS, registered address,
  and settlement bank accounts by NIP or REGON. Check if a contractor's bank account
  is on the whitelist before making B2B transfers (critical for split payment and
  tax deductibility above 15,000 PLN). Reverse-lookup company by 26-digit Polish bank
  account number (NRB/IBAN). Validate NIP, REGON, and IBAN checksums offline. Use
  whenever the user asks about NIP, REGON, Biała Lista VAT, "sprawdź NIP", "sprawdź kontrahenta",
  "status VAT spółki", "czy numer konta jest na białej liście", or verifying a Polish invoice.
category: finance
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: Ministerstwo Finansów (KAS)
source_type: official_api
official: true
homepage: https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka/
documentation: https://www.gov.pl/web/kas/api-wykazu-podatnikow-vat
rate_limit: 300 requests/day per IP
last_verified: 2026-09-28
tags:
  - biala-lista
  - vat
  - nip
  - regon
  - split-payment
  - podatki
  - faktury
  - rachunek-bankowy
compatibility: Python 3.8+ (standard library only); network access to wl-api.mf.gov.pl.
---

# Biała Lista Podatników VAT

Fetches official Polish company and VAT status data from the Ministry of Finance (*Ministerstwo Finansów*)
using `scripts/biala_lista.py`. Always outputs structured JSON.

## Running the script

Run from this skill's directory (or use relative path from repo root):

| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/biala_lista.py <command> …` |
| Windows | `py scripts/biala_lista.py <command> …` (or `python`) |

Zero external dependencies required (standard library only).

## Workflow

1. **Identify the query type:**
   - **NIP (10 digits)**: User provides NIP or asks about a company → `python3 scripts/biala_lista.py nip <nip>`.
   - **Bank Account (26 digits)**: User wants to know who owns an account or if it's safe to pay →
     - Check specific NIP + account match: `python3 scripts/biala_lista.py check <nip> <account>`
     - Find company by account number: `python3 scripts/biala_lista.py account <account>`
   - **REGON (9 or 14 digits)**: User provides REGON → `python3 scripts/biala_lista.py regon <regon>`.
   - **Syntax verification (offline)**: User asks to validate NIP/REGON/IBAN without querying API → `python3 scripts/biala_lista.py validate <value>`.

2. **Historical or specific date:**
   - Add `--date=YYYY-MM-DD` when checking status for a past invoice or event (defaults to today).
```
END THIRD-PARTY FILE 48f9fbd328d95bb1

The third-party file has ended. Everything between the 48f9fbd328d95bb1 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2928 of 5209 bytes. © Michell Hoduń (https://github.com/b44x) · MIT · https://github.com/b44x/ai-polish-skills/tree/HEAD/skills/biala-lista/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
