# eia_oil_supply

Weekly US crude oil supply data from EIA. Metrics: 'production' (US field production), 'imports' (weekly oil imports), 'stocks' (commercial crude stocks), 'refinery_inputs' (gross refinery inputs). Filter by PADD region. Default: national production.

Agent View of the PolicyLayer registry record for `eia_oil_supply`. HTML page: https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/eia-oil-supply

## Facts

- Tool: `eia_oil_supply`
- Server: Livedatalink (`https://livedatalink.ai/mcp`) — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink.md
- Homepage: https://github.com/blackboxfoundry/livedatalink
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server auth posture: open
- Server CORS policy: *
- Server rate-limited: no
- Parameters: 5
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `end` | string | no | Inclusive upper-bound period (ISO date or YYYY-MM). |
| `limit` | number | no | Maximum rows to return (default 50, max 5000). |
| `start` | string | no | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). |
| `metric` | string | no | Metric: 'production', 'imports', 'stocks', 'refinery_inputs'. Default 'production'. |
| `region` | string | no | PADD region or 'national'. Examples: 'national', 'PADD1', 'PADD3'. Default 'national'. |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

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

## Why eia_oil_supply is rated Low

This tool queries and returns historical/current energy supply data from the US Energy Information Administration. It has no capability to modify data, execute commands, delete records, or trigger financial transactions. The filtering and metric selection are parameterized reads only.

From the tool's own definition: "Tool retrieves 'Weekly US crude oil supply data from EIA' with read-only operations: 'production', 'imports', 'stocks', 'refinery_inputs' are all data retrieval metrics. No modifications, deletions, or external side effects are performed."

## Use case

AI agents call eia_oil_supply 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.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Livedatalink:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "eia_oil_supply": {}
  }
}
```

## Other tools on Livedatalink (279)

- `beneficial_owner_screen` — Destructive — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/beneficial-owner-screen.md
- `cdc_dataset_query` — Execute — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-dataset-query.md
- `clinical_site_selector` — Execute — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/clinical-site-selector.md
- `air_quality` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/air-quality.md
- `bank_health_report` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bank-health-report.md
- `bls_indicator` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bls-indicator.md
- `bls_series` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bls-series.md
- `book_details` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-details.md
- `book_fulltext_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-fulltext-search.md
- `book_get_text` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-get-text.md
- `book_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-search.md
- `book_status` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-status.md
- `bounce_scanner` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bounce-scanner.md
- `candlestick_signals` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/candlestick-signals.md
- `cargo_crate` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cargo-crate.md
- `carrier_vetting_score` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/carrier-vetting-score.md
- `caselaw_case_details` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-case-details.md
- `caselaw_citation_lookup` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-citation-lookup.md
- `caselaw_opinion_text` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-opinion-text.md
- `caselaw_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-search.md
- `cdc_drug_overdose_deaths` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-drug-overdose-deaths.md
- `cdc_excess_deaths_covid` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-excess-deaths-covid.md
- `cdc_flu_surveillance` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-flu-surveillance.md
- `cdc_leading_causes_of_death` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-leading-causes-of-death.md
- `cdc_outbreak_reports` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-outbreak-reports.md
- `cdc_vaccination_coverage` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-vaccination-coverage.md
- `cdc_weekly_deaths_by_state` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-weekly-deaths-by-state.md
- `census_business` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-business.md
- `census_commute_employment` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-commute-employment.md
- `census_demographics` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-demographics.md
- …and 249 more: https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-blackboxfoundry-livedatalink · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-blackboxfoundry-livedatalink