deep.navy

Docs / Energy

Energy

Discover supported US Energy Information Administration datasets and fetch energy observations with their original units and source links.

Call it

Use your existing API key. Available tools appear on your combined MCP endpoint when switched on.

			https://mcp.deep.navy/mcp

Check Tools in the dashboard for current availability. Your MCP client reads the current input and output schemas from the server.

Coverage and interpretation

Search the supported dataset catalog before fetching observations. Dataset frequency, dimensions and units differ; retain those fields when comparing values.

The initial catalog covers electricity retail sales, electric-power operations, weekly petroleum stocks and weekly natural-gas storage.

Energy statistics follow their source publication schedule and can be revised. They are not a live commodity-price feed.

Dataset discovery and observation fetching are available in beta through the platform’s EIA connection. Customers do not need a separate EIA API key; availability is shown in the dashboard tool catalog.

Example request: energy_search

Arguments for an MCP tools/call request. The values returned depend on the source’s current data.

{
  "name": "energy_search",
  "arguments": {
    "query": "electricity"
  }
}
energy_fetch

Fetch observations from a supported EIA dataset. Use the columns, frequency and facets returned by energy_search.

Example request: energy_fetch

Arguments for an MCP tools/call request. The values returned depend on the source’s current data.

{
  "name": "energy_fetch",
  "arguments": {
    "dataset": "electricity/retail-sales",
    "column": "price",
    "frequency": "monthly",
    "filters": [
      {
        "facet": "stateid",
        "values": [
          "CA"
        ]
      },
      {
        "facet": "sectorid",
        "values": [
          "RES"
        ]
      }
    ],
    "limit": 12
  }
}
Sources, documentation and reuse

Source: U.S. Energy Information Administration (EIA). EIA permits reuse and distribution of its public data, with exceptions for separately identified third-party content. Keep the returned attribution and source links.