sejm-mcp

Znajdź posła

znajdz_posla

Read-onlyIdempotent

Finds Polish Sejm deputies by name, club, or district, returning the deputy ID needed by other tools. Sort by votes, filter expired mandates, and pick a term or district.

Instructions

Szuka posłów danej kadencji po imieniu lub nazwisku (bez względu na polskie znaki), klubie lub numerze okręgu. Zwraca numer posła (id), którego wymagają inne narzędzia. Klub to przynależność DZIŚ, nie w dniu dawnego głosowania. Przy pośle, którego mandat wygasł, wynik podaje posłów jego okręgu ślubujących później (pole slubowaliPozniejWOkregu), a przy pośle, który ślubował w trakcie kadencji, mandaty wygasłe wcześniej w jego okręgu (wygasliWczesniejWOkregu). Każdy poseł ma glosowWWyborach; sortuj="glosy" układa listę od największej liczby głosów (np. okreg + sortuj="glosy" to ranking okręgu). tylkoWygasle=true: tylko posłowie z wygasłym mandatem, z liczbą według powodu.

Input Schema

TableJSON Schema

Name	Required	Description
`klub`	No	Skrót klubu z rejestru, np. "KO", "PiS", "PSL-TD", "Polska2050"; jednoznaczny początek skrótu ("PSL") też wystarczy
`fraza`	No	Imię i/lub nazwisko, np. "Petru" albo "ryszard petru"
`limit`	No	Ile wyników najwyżej (domyślnie 100, max 100)
`okreg`	No	Numer okręgu wyborczego (1-41)
`sortuj`	No	Kolejność: "rejestr" (domyślnie, alfabetycznie) albo "glosy" (od największej liczby głosów w wyborach)
`kadencja`	No	Numer kadencji Sejmu; domyślnie 10 (bieżąca, od 13 listopada 2023)
`przesuniecie`	No	Od którego wyniku zacząć (stronicowanie)
`tylkoAktywni`	No	Pomiń posłów, których mandat wygasł. Domyślnie tak w bieżącej kadencji, a nie w zakończonych (tam mandat wygasł wszystkim)
`tylkoWygasle`	No	Tylko posłowie, których mandat wygasł przed końcem kadencji (z liczbą według powodu wygaśnięcia)

Output Schema

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

First observedv0.3.0Oct 2, 2026

TDQS

A4.6/5.0

Behavior5/5

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

Goes well beyond the readOnly/idempotent/openWorld annotations: it warns that 'klub' is TODAY's affiliation not the historic one, explains the slubowaliPozniejWOkregu/wygasliWczesniejWOkregu fields for expired and mid-term mandates, and clarifies the glosowWWyborach count and sortuj='glosy' ranking. Rich disambiguation of a politically subtle data model.

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?

Front-loads the core search purpose, then layers special-case semantics in subsequent sentences; each sentence conveys distinct information. It is dense with parenthetical fields but earns most of its length.

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 9-parameter search tool with a high-coverage schema and an output schema, the description supplies exactly the missing behavioral context (today-vs-historic club, mandate-expiry edge cases, sort semantics) an agent needs to call it correctly.

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 baseline is 3, but the description adds cross-parameter meaning the schema cannot convey: okreg + sortuj='glosy' yields a district ranking, and tylkoWygasle returns a count broken down by reason. It does not re-explain syntax already in the schema.

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

Purpose5/5

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

States a specific verb (Szuka) and resource (posłów) plus the three lookup dimensions (name, club, district) and the key output (the id other tools need). An agent can immediately tell this is the roster-search entry point distinct from profil_posla.

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?

Explicitly frames itself as the tool that yields the 'numer posła (id), którego wymagają inne narzędzia', which routes the agent to it before calling detail tools. Lacks explicit when-not-to-use or a named sibling alternative, so it stops short of a 5.

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