dbnomics.data.fetch_series
Fetch the full time-series history for a specific series from DBnomics. Returns an array of {period, value} observations covering up to decades of data. Periods are formatted as YYYY for annual, YYYY-QN for quarterly, YYYY-MM for monthly. Example: provider=WB, dataset=WDI, series=A-US.NY.GDP.MKTP...
This record as markdown: /tools/io-github-whiteknightonhorse-apibase/dbnomics.data.fetch-series.md
What dbnomics.data.fetch_series does on Apibase
AI agents call dbnomics.data.fetch_series 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 |
|---|---|---|---|
series_code | string | Yes | Series code within the dataset (e.g. A-US.NY.GDP.MKTP.CD for US annual nominal GDP in WB/WDI). Use dbnomics.series to browse available codes. |
dataset_code | string | Yes | Dataset code within the provider (e.g. WDI, QNA). Use dbnomics.datasets to list codes. |
provider_code | string | Yes | DBnomics provider code (e.g. WB, OECD, IMF). Use dbnomics.providers to list codes. |
last_n_periods | integer | — | Return only the last N observations (most recent). Omit to return the full history. |
Parameters from the server's own tool schema.
Why dbnomics.data.fetch_series is rated Low
Retrieves historical economic data without modifying, deleting, or executing external operations.
From the tool's definition Fetch the full time-series history for a specific series. Returns an array of observations.
Attacks that exploit this kind of access
The rule that runs dbnomics.data.fetch_series 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 dbnomics.data.fetch_series, this is the rule to start with:
dbnomics.data.fetch_series 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 dbnomics.data.fetch_series call is checked against it from then on.
Questions about dbnomics.data.fetch_series
Fetch the full time-series history for a specific series from DBnomics. Returns an array of {period, value} observations covering up to decades of data. Periods are formatted as YYYY for annual, YYYY-QN for quarterly, YYYY-MM for monthly. Example: provider=WB, dataset=WDI, series=A-US.NY.GDP.MKTP.CD → US nominal GDP in current USD annually. Example: provider=OECD, dataset=QNA, series=USA.B1GQ.LNBARSA.Q → US real GDP quarterly. Use last_n_periods to limit output to the most recent N observations. Covers data from IMF, World Bank, OECD, Eurostat, ECB, BIS, ILO, and 85+ other agencies. No API key required — open data under CC-BY 4.0. It is categorised as a Read tool in the Apibase MCP Server, which means it retrieves data without modifying state.
dbnomics.data.fetch_series accepts 4 parameters: series_code, dataset_code, provider_code, last_n_periods. Required: series_code, dataset_code, provider_code. 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 dbnomics.data.fetch_series: 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.
dbnomics.data.fetch_series 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 dbnomics.data.fetch_series 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 dbnomics.data.fetch_series. 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.
dbnomics.data.fetch_series 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