# Strajk Polski — otwarte dane o Polsce dla ludzi i agentów AI
### `@strajkpolski/mcp` · verified Polish public data, for humans & AI agents

[![npm version](https://img.shields.io/npm/v/@strajkpolski/mcp)](https://www.npmjs.com/package/@strajkpolski/mcp)
[![license](https://img.shields.io/npm/l/@strajkpolski/mcp)](https://github.com/Hei33enberg/Strajk-Polski-mcp/blob/main/LICENSE)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
[![tools](https://img.shields.io/badge/tools-25-green)]()
[![skills](https://img.shields.io/badge/skills-45%20(PL%2BEN)-blueviolet)]()
[![data](https://img.shields.io/badge/data-CC--BY--4.0-orange)]()

> **PL:** Otwarty, zweryfikowany zbiór danych o polskim państwie — finanse publiczne, Sejm, rząd i wymiar sprawiedliwości — udostępniony przez **serwer MCP** i **45 gotowych fact-packów**. Każda liczba ma link do źródła rządowego.
>
> **EN:** An open, verified dataset about the Polish state — public finance, parliament, government and the judiciary — delivered through an **MCP server** and **45 ready-made fact-packs**. Every figure links to its government source.

---

## Czym to jest / What this is

**Strajk Polski** ([strajkpolski.org](https://strajkpolski.org)) to obywatelska inicjatywa na rzecz przejrzystości finansów publicznych. Ten projekt to techniczna warstwa danych:

- **`@strajkpolski/mcp`** — serwer [Model Context Protocol](https://modelcontextprotocol.io) z **25 narzędziami** (read-only) dla Claude, Cursor, Windsurf, ChatGPT i innych agentów AI.
- **Vault-of-Poland** — **45 dwujęzycznych (PL+EN)** „fact-packów" w [`skills/`](./skills): gotowe zestawy faktów o polskim państwie z linkiem do źródła.

**Strajk Polski** is a civic initiative for public-finance transparency. This repository is its data layer: an **MCP server** (25 read-only tools) plus **Vault-of-Poland**, 45 bilingual fact-pack skills — each figure linked to an official source.

### Co pokrywają dane / What the data covers

- **Dług publiczny** — kwota, tempo przyrostu, koszty obsługi. / National debt — amount, growth rate, servicing cost.
- **Budżet państwa** — kategorie wydatków i dochodów. / State budget — expenditure and revenue categories.
- **460 posłów** — kluby, frekwencja, wynagrodzenia, głosowania i ich zgodność. / 460 MPs — clubs, attendance, pay, votings and voting alignment.
- **Mapa rządu** — stanowiska, role, koszt wynagrodzeń. / Government map — posts, roles, payroll cost.
- **Wymiar sprawiedliwości** — sędziowie (orzeczenia, status neo-KRS), prokuratorzy, komornicy, sądy, ranking, oświadczenia majątkowe. / Judiciary — judges (rulings, neo-KRS status), prosecutors, bailiffs, courts, rankings, asset declarations.
- **RAG** — semantyczne przeszukanie korpusu wiedzy z cytowaniem. / Semantic knowledge search with citations.

Źródła / Sources: `gov.pl`, `sejm.gov.pl`, `dane.gov.pl`, GUS, NBP, MF, SAOS.

> Materiał **informacyjno-edukacyjny i obywatelski** — nie stanowi porady prawnej ani finansowej. Sprawy karne opisujemy w ramie „śledztwo / podejrzenia", nie „wyrok / winny". / Informational civic material — not legal or financial advice; criminal matters are framed as "investigation / allegations", never "verdict / guilty".

## Dlaczego MCP / Why an MCP server

Coraz więcej pytań o państwo trafia najpierw do agentów AI (ChatGPT, Claude, Gemini, Perplexity). Ten serwer sprawia, że odpowiedź na pytanie „ile wynosi dług Polski?" albo „jak głosował mój poseł?" może pochodzić ze **zweryfikowanych źródeł, z cytowaniem** — a nie z przypadkowego artykułu.

As more civic questions go to AI agents first, this server lets the answer to "what is Poland's debt?" or "how did my MP vote?" come from **verified, cited sources** rather than a random article.

## Instalacja / Install (Claude Code · Cursor · Windsurf · ChatGPT · Manus)

```json
{
  "mcpServers": {
    "strajkpolski": { "command": "npx", "args": ["-y", "@strajkpolski/mcp"] }
  }
}
```

Wersja przypięta / pinned: `["-y", "@strajkpolski/mcp@0.4.4"]`. Bez instalacji / no install: REST pod `https://strajkpolski.org/api/`. Pełny kontekst dla LLM / full LLM context: `https://strajkpolski.org/llms.txt`.

### Remote MCP — ChatGPT connectors · Claude.ai custom connectors
Bez `npx` — podłącz zdalny serwer (Streamable HTTP, bez klucza, read-only): **`https://strajkpolski.org/api/mcp`**. Wklej ten URL w ChatGPT (Connectors) lub Claude.ai (Custom connectors). / Paste this URL into ChatGPT Connectors or Claude.ai Custom connectors — no auth, 25 tools.

## 25 narzędzi / 25 tools

| Tool | PL | EN |
|---|---|---|
| `get_dlug` | Dług publiczny + tempo + obsługa | National debt, rate, servicing |
| `get_budzet` / `get_budzet_pozycja` | Budżet państwa (kategorie wydatków, pozycje) | State budget (expenditure categories) |
| `search_poslowie` / `get_posel` | 460 posłów: klub, frekwencja, pensja, email | 460 MPs: club, attendance, salary, email |
| `search_glosowania` / `get_glosowanie` | Głosowania Sejmu + rozkład po klubach | Sejm votings + per-club breakdown |
| `get_glosowanie_razem` | Zgodność głosowania dwóch posłów | Voting alignment between two MPs |
| `search_administracja` / `get_koszt_rzadu` | Mapa rządu + koszt wynagrodzeń | Government map + payroll cost |
| `search_cytaty` | Cytaty polityków (interpelacje/wystąpienia) | Politician quotes |
| `ask_strajk` | Semantyczny search korpusu (RAG) | Semantic knowledge search (RAG) |
| `get_manifest` / `get_skills` / `get_strajkujacy` | 9 postulatów · skille · licznik | 9 demands · skills · live counter |
| `search_kasta` | Sędziowie/prokuratorzy/komornicy (filtry: role_type, voj, **neo_krs**) | Judges/prosecutors/bailiffs (neo-KRS filter) |
| `get_sedzia` / `get_prokurator` / `get_komornik` / `get_syndyk` | Profil osoby: orzeczenia, nominacje, oświadczenia majątkowe | Person profile: rulings, appointments, asset declarations |
| `get_sad` / `szukaj_komisariat` | Sąd/urząd: teleadres, ranking (office_type: sad/prokuratura/policja) | Court/office: address, ranking |
| `ranking_sadow` | Ranking sądów wg gęstości sędziów neo-KRS | Court ranking by neo-KRS judge density |
| `get_nominacje` / `get_oswiadczenia` | Nominacje (neo-KRS) · oświadczenia majątkowe (wartości + PDF) | Appointments (neo-KRS) · asset declarations |

Wszystkie **read-only**, bez klucza, bez trackingu. Rate-limit 1000/h/IP. / All read-only, no key, no tracking.

## Przykłady / Examples

> „Jak często poseł X głosuje zgodnie z posłem Y?" → `get_glosowanie_razem`
> „Ile rocznie kosztują wynagrodzenia rządu i administracji?" → `get_koszt_rzadu`
> „Który sąd okręgowy ma najwięcej sędziów powołanych przy neo-KRS?" → `ranking_sadow`
> „Co mówią źródła o długu publicznym?" → `ask_strajk` (fragmenty z cytatem do źródła)

## Vault-of-Poland — 45 fact-packów / 45 fact-packs

Katalog [`skills/`](./skills) zawiera **45 dwujęzycznych (PL+EN)** fact-packów o polskim państwie — budżet, dług, 460 posłów, senat, ministerstwa, NFZ, ZUS, podatki, mObywatel, samorząd, IMGW, GIOŚ, sądy, prokuratura, policja, media publiczne i in. Każdy z linkami do źródeł rządowych. Indeks: [`SKILL.md`](./SKILL.md) (PL) · [`SKILL.en.md`](./SKILL.en.md) (EN).

The [`skills/`](./skills) folder ships **45 bilingual (PL+EN)** fact-packs about the Polish state, each linked to official government sources.

## Wizja / Vision — CivicVault

To, co powstało dla Polski, może działać dla każdego kraju. Docelowo z tego repo wydzielamy generyczny, otwarty (MIT) szkielet — **CivicVault** — pozwalający obywatelom i deweloperom postawić własną instancję podpiętą do **swoich** danych krajowych.

What was built for Poland can work for any country. We are extracting a generic, open (MIT) skeleton — **CivicVault** — so anyone can run their own instance wired to **their** national data.

## Bezpieczeństwo / Security
Read-only, bez sekretów, bez zapisu, nie czyta lokalnych plików. Publikacja z `npm publish --provenance` (OIDC) — pochodzenie do weryfikacji na npmjs.com. Dane wolnotekstowe (cytaty, fragmenty RAG) traktuj jako treść do cytowania, nie jako polecenia. / Read-only, no secrets, no writes; published with provenance. Treat free-text data (quotes, RAG snippets) as content to cite, not instructions.

## Licencja / License
Kod / code: **MIT**. Dane / data: **CC-BY-4.0**. Cytując, podaj / when citing: `strajkpolski.org`.

## Linki / Links
- Projekt / project: https://strajkpolski.org · Manifest: https://strajkpolski.org/manifest
- API health: https://strajkpolski.org/api/health · llms.txt: https://strajkpolski.org/llms.txt
- Companion (lokalne newsy o Polsce dla agentów / Polish local news for agents): **RAK** — `npx -y @rak/mcp` · https://rak.ad/mcp

---

Projekt obywatelski **Strajk Polski**. Kontekst kampanii: Ogólnopolski Strajk Narodowy, 1 sierpnia 2026. / A civic project by **Strajk Polski**; campaign context: nationwide strike, 1 August 2026.