Skip to main content
Glama

Podziemie Analityczne

Search series

podziemie_search_series
Read-onlyIdempotent

Find series in the catalogue by words (Polish or English) or list a category; returns ids for the other tools. Rows of any publisher beyond gus, nbp, worldbank, eurostat and podziemie come in outside, not items; rows of a frequency beyond monthly, quarterly and yearly (semiannual, daily) come in outsideFrequency.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "podziemie_search_series"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoAt most this many series (default 10, at most 20).
queryNoWords to find, in Polish or English; empty lists the category (or everything).
cursorNonextCursor from the previous page.
categoryNoLimit to a legacy category alias, a top category, or one primary leaf. Legacy aliases keep matching the row's category; tree ids match categoryPath.
frequencyNoLimit to one frequency.
publisherNoLimit to one publisher, as the dataset files name it (sejm, utk, oecd, kgp…); podziemie is a series the site derives.
visibilityNoLimit to rows with a page on the site, or to data-only rows.
geographyLevelNoLimit to one geography: Poland as a whole, its voivodeships (NUTS 2 regions included) or countries.

Output Schema

NameRequiredDescriptionDefault
itemsYes
matchYes
totalYes
facetsYes
statusYes
outsideNo
nextCursorYes
outsideFrequencyNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / category / enum
      Previous value: -[
      -  "ceny",
      -  "praca",
      -  "pkb",
      -  "handel",
      -  "finanse",
      -  "spoleczenstwo",
      -  "srodowisko",
      -  "gospodarka",
      -  "handel-zagraniczny",
      -  "finanse-publiczne",
      -  "pieniadz",
      -  "ludnosc",
      -  "dochody",
      -  "mieszkania",
      -  "zdrowie",
      -  "edukacja-nauka",
      -  "technologie",
      -  "bezpieczenstwo",
      -  "transport",
      -  "kultura-turystyka",
      -  "energia-srodowisko",
      -  "rolnictwo",
      -  "inflacja",
      -  "ceny-produktow-uslug",
      -  "ceny-producentow",
      -  "ceny-surowcow",
      -  "deflatory",
      -  "bezrobocie",
      -  "zatrudnienie",
      -  "wynagrodzenia",
      -  "wolne-miejsca-pracy",
      -  "koszty-pracy",
      -  "rachunki-narodowe",
      -  "koniunktura",
      -  "przemysl-budownictwo",
      -  "handel-uslugi",
      -  "firmy",
      -  "eksport-import",
      -  "kraje-partnerskie",
      -  "ceny-handlu-zagranicznego",
      -  "bilans-platniczy",
      -  "budzet-panstwa",
      -  "dochody-wydatki-panstwa",
      -  "dlug-deficyt",
      -  "zamowienia-publiczne",
      -  "stopy-procentowe",
      -  "kursy-walut",
      -  "pieniadz-kredyt",
      -  "liczba-ludnosci",
      -  "urodzenia",
      -  "zgony",
      -  "migracje",
      -  "malzenstwa-rozwody",
      -  "dochody-gospodarstw-domowych",
      -  "ubostwo",
      -  "emerytury-swiadczenia",
      -  "wybory",
      -  "ceny-mieszkan",
      -  "budowa-mieszkan",
      -  "zasoby-mieszkaniowe",
      -  "kredyty-mieszkaniowe",
      -  "lekarze-pielegniarki",
      -  "szpitale",
      -  "szkoly-uczelnie",
      -  "badania-rozwoj",
      -  "internet-w-domu",
      -  "cyfryzacja-firm",
      -  "handel-internetowy",
      -  "przestepstwa",
      -  "wykrywalnosc",
      -  "pojazdy",
      -  "wypadki-drogowe",
      -  "kultura",
      -  "sport",
      -  "turystyka",
      -  "energia",
      -  "odpady-woda-lasy",
      -  "ceny-rolne",
      -  "produkcja-rolna"
      -]New value: +[
      +  "ceny",
      +  "praca",
      +  "pkb",
      +  "handel",
      +  "finanse",
      +  "spoleczenstwo",
      +  "srodowisko",
      +  "gospodarka",
      +  "handel-zagraniczny",
      +  "finanse-publiczne",
      +  "pieniadz",
      +  "ludnosc",
      +  "dochody",
      +  "mieszkania",
      +  "zdrowie",
      +  "edukacja-nauka",
      +  "technologie",
      +  "bezpieczenstwo",
      +  "transport",
      +  "kultura-turystyka",
      +  "energia-srodowisko",
      +  "rolnictwo",
      +  "inflacja",
      +  "ceny-produktow-uslug",
      +  "ceny-producentow",
      +  "ceny-surowcow",
      +  "deflatory",
      +  "bezrobocie",
      +  "zatrudnienie",
      +  "wynagrodzenia",
      +  "wolne-miejsca-pracy",
      +  "koszty-pracy",
      +  "rachunki-narodowe",
      +  "koniunktura",
      +  "przemysl-budownictwo",
      +  "handel-uslugi",
      +  "firmy",
      +  "eksport-import",
      +  "kraje-partnerskie",
      +  "ceny-handlu-zagranicznego",
      +  "bilans-platniczy",
      +  "budzet-panstwa",
      +  "dochody-wydatki-panstwa",
      +  "dlug-deficyt",
      +  "zamowienia-publiczne",
      +  "stopy-procentowe",
      +  "kursy-walut",
      +  "pieniadz-kredyt",
      +  "liczba-ludnosci",
      +  "urodzenia",
      +  "zgony",
      +  "migracje",
      +  "malzenstwa-rozwody",
      +  "dochody-gospodarstw-domowych",
      +  "ubostwo",
      +  "emerytury-swiadczenia",
      +  "wybory",
      +  "ceny-mieszkan",
      +  "budowa-mieszkan",
      +  "zasoby-mieszkaniowe",
      +  "kredyty-mieszkaniowe",
      +  "lekarze-pielegniarki",
      +  "szpitale",
      +  "szkoly-uczelnie",
      +  "badania-rozwoj",
      +  "internet-w-domu",
      +  "cyfryzacja-firm",
      +  "handel-internetowy",
      +  "przestepstwa",
      +  "wykrywalnosc",
      +  "pojazdy",
      +  "wypadki-drogowe",
      +  "kultura",
      +  "sport",
      +  "turystyka",
      +  "energia",
      +  "odpady-woda-lasy",
      +  "ochrona-przyrody",
      +  "ceny-rolne",
      +  "produkcja-rolna"
      +]
  2. First observed

TDQS

A4.2/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, closed-world, so safety needs no restating. The description then earns credit for non-obvious output behavior: rows filtered by publishers outside the five core ones land in `outside`, and semiannual/daily frequencies land in `outsideFrequency` — something an agent could not infer from the schema. It is silent on pagination semantics (cursor/nextCursor) beyond what the schema states, keeping this at adequate rather than rich.

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

Conciseness5/5

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

Two sentences, front-loaded with the primary action, then the caveat that prevents misuse of the results. Nothing is padded and the backticked field names make the exception easy to scan.

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

Completeness4/5

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

With an output schema present, return values need not be described, and the description still covers the one surprising aspect of the response shape. It does not mention pagination or the default/limit of 10–20, though the schema carries both, so coverage is close to complete for an 8-parameter search tool.

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. The description goes further by explaining that the query accepts Polish or English and that an empty query lists the whole category, and it links publisher/frequency choices to where the results appear (`outside`, `outsideFrequency`) — meaning the schema alone does not convey.

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 and resource ('Find series in the catalogue') plus the two operating modes (word search or category listing) and its role in the workflow ('returns ids for the other tools'), which positions it distinctly against get_series/describe_series/related_series.

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?

Gives clear entry conditions — supply words in Polish or English, or an empty query to list a category, and it makes clear the output feeds the other tools. It stops short of explicit when-not-to-use guidance (e.g. 'use get_observations once you have an id'), so it is clear context rather than full routing.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources