Polish public statistics (GUS, NBP, Eurostat) with unit, period and source. Data tools only read.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
What one series measures: unit, meaning, frequency, coverage, comparability breaks, publisher and licence.
Public series id: a slug or <dataset>/<dimension>=<code>.
Series id, e.g. "inflacja-cpi" (from podziemie_search_series).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http dane https://www.podziemieanalityczne.pl/mcp
What one series measures: unit, meaning, frequency, coverage, comparability breaks, publisher and licence.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id: a slug or <dataset>/<dimension>=<code>. |
| slug | string | Series id, e.g. "inflacja-cpi" (from podziemie_search_series). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id: a slug or <dataset>/<dimension>=<code>."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "Series id, e.g. \"inflacja-cpi\" (from podziemie_search_series)."
}
},
"additionalProperties": false
}Stores a podziemie.dashboard/1 document as a private draft for 24 hours and returns its link. Not listed anywhere; whoever opens the link can read it, and the person signs in there to save it to their dashboards (Polish UI: raporty). A document that fails the checks is not stored, and each problem comes back with its JSON pointer.
| Argument | Type | Description |
|---|---|---|
| dashboard* | string | A podziemie.dashboard/1 document as JSON text: {"$schema":"podziemie.dashboard/1","title":…,"tiles":[…]}, the shape of podziemie_get_dashboard's `dashboard` (chart, number and text tiles). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dashboard"
],
"properties": {
"dashboard": {
"type": "string",
"maxLength": 16384,
"minLength": 2,
"description": "A podziemie.dashboard/1 document as JSON text: {\"$schema\":\"podziemie.dashboard/1\",\"title\":…,\"tiles\":[…]}, the shape of podziemie_get_dashboard's `dashboard` (chart, number and text tiles)."
}
},
"additionalProperties": false
}Find the code of a place or country by name or code in the shared code lists, with its level and parent: geography takes a Polish voivodeship name or TERYT code and, once places launch, a powiat, gmina (TERC) or village (SIMC) name or code, a village with its gmina and an abolished unit with its end date (podziemie_get_place reads their values); country takes a Polish or English name or an ISO 3166-1 alpha-2 or alpha-3 code (the Eurostat codes UK and EL also work); with dataset, the series ids for the other tools. Several fitting names come back as ambiguous.
| Argument | Type | Description |
|---|---|---|
| level | string | Only members of this level; village is a member with no level of its own. |
| limit | integer | At most this many members (default 20, at most 50). |
| query | string | A name or code, with or without Polish diacritics: geography by Polish name or TERYT code ("Mazowieckie", "14"; once places launch also "bocheński", "Nowy Wiśnicz", "1201063" or a village name); country by Polish or English name or ISO 3166-1 alpha-2 or alpha-3 code ("Niemcy", "Germany", "DE", "DEU"; "UK" and "EL" are Eurostat codes, ISO has GB and GR). Omit to list. |
| dataset | string | A dataset id, e.g. "bezrobocie-wojewodztwa": only its members, each with its series id. |
| dimension* | string | Shared dimension: geography holds TERYT codes, country ISO 3166-1 alpha-2 codes and publisher area aggregates. |
One dashboard (Polish UI: raport), ours by slug or a user's public one by its address: the podziemie.dashboard/1 document (its tiles hold no values) and, for each series it draws, the podziemie_get_value answer for its latest reading: value, period and citation, or why there is none. A table by place it draws is named in tables, for podziemie_get_observations with dataset. The same answer as the dashboard's address with .json.
| Argument | Type | Description |
|---|---|---|
| report* | string | A slug from podziemie_list_dashboards, or a public user report's address (https://…/raporty/<title>-<code>). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"report"
],
"properties": {
"report": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "A slug from podziemie_list_dashboards, or a public user report's address (https://…/raporty/<title>-<code>)."
}
},
"additionalProperties": false
}Every series to walk to from one series, as the dependency map on the site draws it: stored links with their direction and evidence (the stored basis), other measures of the same concept, the same measure at a neighbouring place or for the whole country, and other measures at the same place. With familyTable it also returns the family table its site page shows: every member's latest value, unit and change, and, where the family compares with Polska, the gap to Polska and the place. Call it again on a neighbour to walk on. Navigation hints, not proof of a cause.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id: a slug or <dataset>/<dimension>=<code>. |
| slug | string | Series id, e.g. "inflacja-cpi" (from podziemie_search_series). |
| limit | integer | At most this many neighbours, in the map's order; default every one. |
| relations | array | Only these relations; default every one. variant: another measure of the same concept; family: the same measure one step away (a neighbouring place, the whole country, another group); place: another measure at the same place; the rest are stored links. |
| familyTable | boolean | Also return the family table the series' page shows: each member's latest value, unit and change, and the gap to Polska and the place where the family compares with Polska. It reads up to about a hundred series, so it is off by default. |
Read up to 20 series ids or a member dataset with named dimension filters. Returns the last 24 periods by default, at most 1,500 cells and 24,000 characters, with Polish citations, licences and a cursor plus data links for the rest.
| Argument | Type | Description |
|---|---|---|
| to | string | Last period, in each series' periodShape. |
| ids | array | 1 to 20 series ids: a slug (from podziemie_search_series) or <dataset>/<dimension>=<code>. |
| from | string | First period, in each series' periodShape. |
| lastN | integer | The last n periods (default 24 without a range). |
| cursor | string | nextCursor from the previous answer. |
| detail | string | full adds raw values, coverage and identity fields. |
| filter | object | With dataset: {<dimension>: code | [codes] | "*"}; omitted means every member. |
| dataset | string | A member dataset, e.g. "bezrobocie-wojewodztwa"; use instead of ids. |
One powiat, gmina or village (its codelist and code from podziemie_find_members): the newest value of every published place table for it, each with its period, unit, source line, and its rank among the units of its level or why it has none (villages and places too small to rank have none). A value GUS withholds comes back null, never 0. An abolished unit answers with its end date and no value. Answers not-available until places launch.
| Argument | Type | Description |
|---|---|---|
| code* | string | The place's code in that list, e.g. "1201" (powiat), "1201063" (gmina) or "0950463" (village). |
| codelist* | string | The place list, as podziemie_find_members names it: teryt-powiaty (powiat), teryt-gminy (gmina, TERC with its type digit) or simc-miejscowosci (village). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"codelist",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\d{4}$|^\\d{7}$",
"description": "The place's code in that list, e.g. \"1201\" (powiat), \"1201063\" (gmina) or \"0950463\" (village)."
},
"codelist": {
"enum": [
"teryt-powiaty",
"teryt-gminy",
"simc-miejscowosci"
],
"type": "string",
"description": "The place list, as podziemie_find_members names it: teryt-powiaty (powiat), teryt-gminy (gmina, TERC with its type digit) or simc-miejscowosci (village)."
}
},
"additionalProperties": false
}Release dates with their status (planned, published, late, unconfirmed), and series updated since a day by a new period or a revised value.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id, as podziemie_describe_series takes; omit for every series. |
| to | string | Last release day, YYYY-MM-DD (default: every known date). |
| from | string | First release day, YYYY-MM-DD (default: 7 days ago; at most 90 days back). |
| updatedSince | string | List series updated on or after this day, YYYY-MM-DD (default: 7 days ago; at most 30 days back). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id, as podziemie_describe_series takes; omit for every series."
},
"to": {
"type": "string",
"pattern": "^(19\\d{2}|2\\d{3})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"description": "Last release day, YYYY-MM-DD (default: every known date)."
},
"from": {
"type": "string",
"pattern": "^(19\\d{2}|2\\d{3})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"description": "First release day, YYYY-MM-DD (default: 7 days ago; at most 90 days back)."
},
"updatedSince": {
"type": "string",
"pattern": "^(19\\d{2}|2\\d{3})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"description": "List series updated on or after this day, YYYY-MM-DD (default: 7 days ago; at most 30 days back)."
}
},
"additionalProperties": false
}Readings of a series over a range of periods (the last 24 when no range is given), with comparability breaks in the range.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id: a slug or <dataset>/<dimension>=<code>. |
| to | string | Last period, in the series' periodShape. |
| from | string | First period, in the series' periodShape. |
| slug | string | Series id, e.g. "inflacja-cpi" (from podziemie_search_series). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id: a slug or <dataset>/<dimension>=<code>."
},
"to": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"maxLength": 16,
"minLength": 1,
"description": "Last period, in the series' periodShape."
},
"from": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"maxLength": 16,
"minLength": 1,
"description": "First period, in the series' periodShape."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "Series id, e.g. \"inflacja-cpi\" (from podziemie_search_series)."
}
},
"additionalProperties": false
}One reading of a series for a period (the latest when no period is given), with its unit, meaning and a Polish citation.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id: a slug or <dataset>/<dimension>=<code>. |
| slug | string | Series id, e.g. "inflacja-cpi" (from podziemie_search_series). |
| period | string | YYYY-MM, YYYY-Qn or YYYY, as the series' periodShape says; omit for the latest reading. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id: a slug or <dataset>/<dimension>=<code>."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "Series id, e.g. \"inflacja-cpi\" (from podziemie_search_series)."
},
"period": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"maxLength": 16,
"minLength": 1,
"description": "YYYY-MM, YYYY-Qn or YYYY, as the series' periodShape says; omit for the latest reading."
}
},
"additionalProperties": false
}The dashboards (Polish UI: raporty): the site's own (kind ours), then readers' public ones, the most followed first (kind reader, with followers; at most 100, no author). Each with slug, title, description, page and JSON address; podziemie_get_dashboard reads one by its slug. readersUnavailable: true says the readers' list could not be read just now.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}The site's profile of Poland (Poznaj Polskę) as one tree: twelve segments (population, work, prices, the economy, regions and more), each with its headline's latest reading and the page it leads to. A segment with its own page adds its year range, the series and table ids its charts draw, its facts and its links. The same tree as GET /api/poznaj.
| Argument | Type | Description |
|---|---|---|
| segment | string | One segment by its id; default every segment. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"segment": {
"enum": [
"ludnosc",
"praca",
"ceny",
"gospodarka",
"pieniadz",
"mieszkania",
"zdrowie",
"edukacja",
"energia",
"panstwo",
"regiony",
"europa"
],
"type": "string",
"description": "One segment by its id; default every segment."
}
},
"additionalProperties": false
}The accepted, current links stored for a series, the record its page takes its links from: formula inputs, components, price-chain steps, publisher-stated mechanisms and reviewed "see also" series, each with its kind, tier, basis and direction. Navigation hints, not proof of a cause.
| Argument | Type | Description |
|---|---|---|
| id | string | Public series id: a slug or <dataset>/<dimension>=<code>. |
| slug | string | Series id, e.g. "inflacja-cpi" (from podziemie_search_series). |
| kinds | array | Only links of these kinds; default every kind. |
| tiers | array | core: a formula, component, price-chain step or publisher-stated mechanism; worth_seeing: a reviewed "see also" pointer, never a cause. Default both. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id: a slug or <dataset>/<dimension>=<code>."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "Series id, e.g. \"inflacja-cpi\" (from podziemie_search_series)."
},
"kinds": {
"type": "array",
"items": {
"enum": [
"part_of",
"derived_from",
"pair",
"worth_seeing",
"affects",
"chain"
],
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"description": "Only links of these kinds; default every kind."
},
"tiers": {
"type": "array",
"items": {
"enum": [
"core",
"worth_seeing"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"description": "core: a formula, component, price-chain step or publisher-stated mechanism; worth_seeing: a reviewed \"see also\" pointer, never a cause. Default both."
}
},
"additionalProperties": false
}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`.
| Argument | Type | Description |
|---|---|---|
| limit | integer | At most this many series (default 10, at most 20). |
| query | string | Words to find, in Polish or English; empty lists the category (or everything). |
| cursor | string | nextCursor from the previous page. |
| category | string | Limit to a legacy category alias, a top category, or one primary leaf. Legacy aliases keep matching the row's category; tree ids match categoryPath. |
| frequency | string | Limit to one frequency. |
| publisher | string | Limit to one publisher, as the dataset files name it (sejm, utk, oecd, kgp…); podziemie is a series the site derives. |
| visibility | string | Limit to rows with a page on the site, or to data-only rows. |
| geographyLevel |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.
| containedIn | string | A TERYT code: only members inside it, e.g. "12" for the members inside Małopolskie. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dimension"
],
"properties": {
"level": {
"enum": [
"voivodeship",
"powiat",
"gmina",
"country",
"village"
],
"type": "string",
"description": "Only members of this level; village is a member with no level of its own."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "At most this many members (default 20, at most 50)."
},
"query": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "A name or code, with or without Polish diacritics: geography by Polish name or TERYT code (\"Mazowieckie\", \"14\"; once places launch also \"bocheński\", \"Nowy Wiśnicz\", \"1201063\" or a village name); country by Polish or English name or ISO 3166-1 alpha-2 or alpha-3 code (\"Niemcy\", \"Germany\", \"DE\", \"DEU\"; \"UK\" and \"EL\" are Eurostat codes, ISO has GB and GR). Omit to list."
},
"dataset": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "A dataset id, e.g. \"bezrobocie-wojewodztwa\": only its members, each with its series id."
},
"dimension": {
"enum": [
"geography",
"sex",
"age",
"sector",
"country",
"currency",
"product",
"education",
"basis",
"station",
"averaging",
"rate",
"adjustment",
"group"
],
"type": "string",
"description": "Shared dimension: geography holds TERYT codes, country ISO 3166-1 alpha-2 codes and publisher area aggregates."
},
"containedIn": {
"type": "string",
"pattern": "^[A-Za-z0-9]{1,32}$",
"description": "A TERYT code: only members inside it, e.g. \"12\" for the members inside Małopolskie."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Public series id: a slug or <dataset>/<dimension>=<code>."
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,80}$",
"description": "Series id, e.g. \"inflacja-cpi\" (from podziemie_search_series)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "At most this many neighbours, in the map's order; default every one."
},
"relations": {
"type": "array",
"items": {
"enum": [
"part_of",
"derived_from",
"chain",
"affects",
"pair",
"worth_seeing",
"variant",
"family",
"place"
],
"type": "string"
},
"maxItems": 9,
"minItems": 1,
"description": "Only these relations; default every one. variant: another measure of the same concept; family: the same measure one step away (a neighbouring place, the whole country, another group); place: another measure at the same place; the rest are stored links."
},
"familyTable": {
"type": "boolean",
"description": "Also return the family table the series' page shows: each member's latest value, unit and change, and the gap to Polska and the place where the family compares with Polska. It reads up to about a hundred series, so it is off by default."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"maxLength": 16,
"minLength": 1,
"description": "Last period, in each series' periodShape."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 20,
"minItems": 1,
"description": "1 to 20 series ids: a slug (from podziemie_search_series) or <dataset>/<dimension>=<code>."
},
"from": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"maxLength": 16,
"minLength": 1,
"description": "First period, in each series' periodShape."
},
"lastN": {
"type": "integer",
"maximum": 600,
"minimum": 1,
"description": "The last n periods (default 24 without a range)."
},
"cursor": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "nextCursor from the previous answer."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"description": "full adds raw values, coverage and identity fields."
},
"filter": {
"type": "object",
"description": "With dataset: {<dimension>: code | [codes] | \"*\"}; omitted means every member.",
"propertyNames": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 40,
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
}
]
}
},
"dataset": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "A member dataset, e.g. \"bezrobocie-wojewodztwa\"; use instead of ids."
}
},
"additionalProperties": false
}| string |
| Limit to one geography: Poland as a whole, its voivodeships (NUTS 2 regions included) or countries. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "At most this many series (default 10, at most 20)."
},
"query": {
"type": "string",
"maxLength": 132,
"description": "Words to find, in Polish or English; empty lists the category (or everything)."
},
"cursor": {
"type": "string",
"pattern": "^\\d{1,4}$",
"description": "nextCursor from the previous page."
},
"category": {
"enum": [
"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"
],
"type": "string",
"description": "Limit to a legacy category alias, a top category, or one primary leaf. Legacy aliases keep matching the row's category; tree ids match categoryPath."
},
"frequency": {
"enum": [
"monthly",
"quarterly",
"yearly",
"semiannual",
"daily"
],
"type": "string",
"description": "Limit to one frequency."
},
"publisher": {
"enum": [
"gus",
"nbp",
"worldbank",
"eurostat",
"podziemie",
"mc",
"utk",
"kgp",
"kbw",
"mf",
"sejm",
"wikimedia",
"user",
"gios",
"oecd",
"ted",
"cert",
"ember",
"ec",
"mrirw"
],
"type": "string",
"description": "Limit to one publisher, as the dataset files name it (sejm, utk, oecd, kgp…); podziemie is a series the site derives."
},
"visibility": {
"enum": [
"page",
"data-only"
],
"type": "string",
"description": "Limit to rows with a page on the site, or to data-only rows."
},
"geographyLevel": {
"enum": [
"national",
"voivodeship",
"country"
],
"type": "string",
"description": "Limit to one geography: Poland as a whole, its voivodeships (NUTS 2 regions included) or countries."
}
},
"additionalProperties": false
}