eia_series_lookup
Flexible EIA series lookup. Pass any EIA series ID (e.g. 'PET.RWTC.D' for WTI crude daily, 'NG.RNGWHHD.D' for Henry Hub spot daily, 'ELEC.PRICE.US-ALL.M' for US average electricity retail price monthly). Returns time-series data for that series. Use this when no other tool covers your specific need.
This record as markdown: /tools/io-github-blackboxfoundry-livedatalink/eia-series-lookup.md
What eia_series_lookup does on Livedatalink
AI agents call eia_series_lookup to retrieve information from Livedatalink 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 |
|---|---|---|---|
end | string | — | Inclusive upper-bound period (ISO date or YYYY-MM). |
limit | number | — | Maximum rows to return (default 50, max 5000). |
start | string | — | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). |
series_id | string | Yes | EIA series ID. See https://www.eia.gov/opendata/browser/ for the full catalog. |
Parameters from the server's own tool schema.
Why eia_series_lookup is rated Low
This tool performs data retrieval only—it accepts a series identifier and returns historical time-series data. There are no side effects, data modifications, code execution, deletions, or financial transactions. It is a read-only query operation against a public energy data source, presenting minimal risk even if misused by an AI agent.
From the tool's definition Tool description states it 'Returns time-series data for that series' and 'Pass any EIA series ID'. The function is to retrieve and query energy information data from the EIA (U.S.
Attacks that exploit this kind of access
The rule that runs eia_series_lookup safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Livedatalink, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For eia_series_lookup, this is the rule to start with:
eia_series_lookup 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 Livedatalink, apply this rule, and every eia_series_lookup call is checked against it from then on.
Questions about eia_series_lookup
Flexible EIA series lookup. Pass any EIA series ID (e.g. 'PET.RWTC.D' for WTI crude daily, 'NG.RNGWHHD.D' for Henry Hub spot daily, 'ELEC.PRICE.US-ALL.M' for US average electricity retail price monthly). Returns time-series data for that series. Use this when no other tool covers your specific need. It is categorised as a Read tool in the Livedatalink MCP Server, which means it retrieves data without modifying state.
eia_series_lookup accepts 4 parameters: end, limit, start, series_id. Required: series_id. The full parameter table on this page comes from the server's own tool schema.
Register the Livedatalink MCP server in PolicyLayer and add a rule for eia_series_lookup: 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 Livedatalink. Nothing to install.
eia_series_lookup 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 eia_series_lookup 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 eia_series_lookup. 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.
eia_series_lookup is provided by the Livedatalink MCP server (https://livedatalink.ai/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Livedatalink, and thousands of servers like it.
This server
Across the catalogue