istat.series.data
Get observation values for an ISTAT dataflow (dataflow_id from istat.dataflows). Use key (from istat.structure) to filter by frequency/territory/measure, e.g. "A.IT...." for Italy annual data, all other dimensions unfiltered — an unscoped key can match thousands of series. Control the time range ...
This record as markdown: /tools/io-github-whiteknightonhorse-apibase/istat.series.data.md
What istat.series.data does on Apibase
AI agents call istat.series.data to retrieve information from Apibase without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | — | SDMX dot-separated dimension filter key in dimension position order (e.g. "A.IT...." for annual national-level data, all other dimensions unfiltered). Use istat |
end_period | string | — | End of period range, e.g. "2024" (annual) or "2024-12" (monthly). Takes precedence over last_n_observations when set. |
dataflow_id | string | Yes | ISTAT dataflow id, from istat.dataflows (e.g. "101_1015_DF_DCSP_COLTIVAZIONI_1" for crop areas and production). |
start_period | string | — | Start of period range, e.g. "2020" (annual) or "2020-01" (monthly). Takes precedence over last_n_observations when set. |
last_n_observations | integer | — | Return only the most recent N observations per series (max 20, default 5). Ignored if start_period or end_period is set. Kept low because a wide key can already |
Parameters from the server's own tool schema.
Why istat.series.data is rated Low
Retrieves time-series statistical data from public ISTAT API without side effects or data modification.
From the tool's definition Get observation values for an ISTAT dataflow; public REST API, no auth required.
Attacks that exploit this kind of access
The rule that runs istat.series.data safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Apibase, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For istat.series.data, this is the rule to start with:
istat.series.data is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Apibase, apply this rule, and every istat.series.data call is checked against it from then on.
Questions about istat.series.data
Get observation values for an ISTAT dataflow (dataflow_id from istat.dataflows). Use key (from istat.structure) to filter by frequency/territory/measure, e.g. "A.IT...." for Italy annual data, all other dimensions unfiltered — an unscoped key can match thousands of series. Control the time range with start_period/end_period or last_n_observations (max 20). Data: esploradati.istat.it (ISTAT SDMX public REST API), no auth required. It is categorised as a Read tool in the Apibase MCP Server, which means it retrieves data without modifying state.
istat.series.data accepts 5 parameters: key, end_period, dataflow_id, start_period, last_n_observations. Required: dataflow_id. The full parameter table on this page comes from the server's own tool schema.
Register the Apibase MCP server in PolicyLayer and add a rule for istat.series.data: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Apibase. Nothing to install.
istat.series.data is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the istat.series.data rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for istat.series.data. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
istat.series.data is provided by the Apibase MCP server (apibase-mcp-client). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Apibase, and thousands of servers like it.
This server
Across the catalogue