sejm-mcp

Tekst druku sejmowego

tekst_druku

Read-onlyIdempotent

Instructions

Pełny tekst druku sejmowego (projekt ustawy, uzasadnienie, OSR, opinie) strona po stronie, z pliku PDF, DOCX albo DOC, ze spisem treści (działy, rozdziały, artykuły, uzasadnienie) i numerami stron. Duży druk pokazuje porcjami: najpierw spis i pierwsze strony, potem strony="11-20" albo artykul="52". Plik pobiera z api.sejm.gov.pl raz i trzyma na dysku użytkownika: do 20 MB bez pytania, większy dopiero za zgodą użytkownika. Strony bez warstwy tekstowej (skany) są oznaczone; odczyt maszynowy daje ocr=true (wynik oznaczony jako odczyt maszynowy). Parametr fraza: zamiast stron same trafienia w całym pliku z kontekstem i stroną do cytowania (pokazano, nastepneOd jako od do dalszych). Cytując albo streszczając druk, zawsze podaj numer druku, nazwę pliku i numer strony (przy Wordzie numer części i artykuł) oraz link z pola cytowanie.url; zaproponuj użytkownikowi otwarcie oryginału („Otworzyć plik, żeby sprawdzić?”). Nie parafrazuj treści druku bez wskazania pliku i strony.

Input Schema

Name	Required	Description
`od`	No	Z fraza: szukaj od tego znaku tekstu pliku (nastepneOd z poprzedniej odpowiedzi)
`ocr`	No	Odczyt maszynowy (OCR) stron-skanów w pokazanym zakresie, na tym komputerze; ponad 10 stron naraz tylko za zgodą użytkownika
`plik`	No	Nazwa pliku z listy plików druku (np. "2457-ustawa.docx"); domyślnie główny PDF druku
`fraza`	No	Szukaj tej frazy w tekście (bez wielkości liter, z polskimi znakami): zamiast porcji zwraca tylko trafienia z kontekstem i ich pozycje (od)
`numer`	Yes	Numer druku, np. "2457", "851-A" albo "2457-001" (druk dodatkowy)
`zgoda`	No	Tylko gdy użytkownik zgodził się na to, o co pytało poprzednie wywołanie (pole potrzebnaZgoda): klucz zgody, np. ["duzy-plik"] albo ["ocr"]
`strony`	No	Strony do pokazania: "5" albo "5-12" (najwyżej 50 naraz); w pliku Word to numery części
`znakow`	No	Najwięcej znaków tekstu w odpowiedzi (domyślnie 20000, max 25000)
`artykul`	No	Numer artykułu druku, np. "12" albo "12a": pokaże strony od miejsca, gdzie się zaczyna
`odswiez`	No	Pobierz plik z Sejmu od nowa zamiast z dysku
`kadencja`	No	Numer kadencji Sejmu; domyślnie 10 (bieżąca, od 13 listopada 2023)

Output Schema

Name	Required	Description
`uwagi`	No
`zrodla`	Yes
`kalendarz`	No
`wynikCzesciowy`	No	Tylko przy wyniku NIEPEŁNYM: powiedz to użytkownikowi na początku

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedv0.3.1Oct 14, 2026

addedInput schema / properties / fraza

Added value: +{
+  "description": "Szukaj tej frazy w tekście (bez wielkości liter, z polskimi znakami): zamiast porcji zwraca tylko trafienia z kontekstem i ich pozycje (od)",
+  "maxLength": 200,
+  "minLength": 2,
+  "type": "string"
+}

addedInput schema / properties / od

Added value: +{
+  "default": 0,
+  "description": "Z fraza: szukaj od tego znaku tekstu pliku (nastepneOd z poprzedniej odpowiedzi)",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

First observedv0.3.0Oct 2, 2026

TDQS

A4.3/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/openWorld/idempotent annotations, it discloses substantial behavior: the file is fetched once from api.sejm.gov.pl and cached on the user's disk, downloads up to 20 MB proceed without asking while larger ones require consent, OCR runs locally and is capped over 10 pages without consent, scanned pages are flagged, and citation obligations (numer druku, filename, page, cytowanie.url, offering to open the original) are spelled out.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the purpose and each sentence carries operational content, but it is one dense, run-on block with no formatting, and it re-states several schema facts (fraza behavior, zgoda keys, page format) rather than trusting the schema. Sized acceptably for an 11-parameter tool with consent gating.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool this complex — 11 parameters, chunked reads, consent escalation, OCR — the description covers the whole flow: initial fetch, paging, phrase search, consent handoff, and citation duties. With an output schema present it need not document return values, yet it still names useful response fields (potrznaZgoda-style consent key, nastepneOd, cytowanie.url), leaving no gap an agent would hit when calling it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds cross-parameter workflow meaning the schema does not: fraza swaps the page payload for hits with context, strony/artykul/nastepneOd form a continuation loop, and zgoda is conditional on a prior response's potrzebnaZgoda field. That framing is genuinely additive over per-field docs.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource — the full text of a Sejm print (bill, justification, OSR, opinions) delivered page by page from PDF/DOCX/DOC with a table of contents and page numbers. It is unmistakably about extracting print content, not print metadata, but it never names the sibling (e.g. `druk`) it complements, so an agent must infer the split from context alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear operating context: large prints arrive in chunks, continue with strony="11-20" or artykul="52", use fraza to get hits instead of pages, set ocr=true for scanned pages, and pass zgoda only after a prior call returned potrzebnaZgoda. That is strong within-tool routing, but it never states when to prefer this tool over `druk` or `tresc_aktu`, so no explicit exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.