MCP server

Eia Energy

io.github.cyanheads/eia-energy-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

6

Token cost

About 4,245 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http eia-energy-mcp-server https://eia-energy.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.eia-energy-mcp-server]
url = "https://eia-energy.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"eia-energy-mcp-server":{"httpUrl":"https://eia-energy.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"eia-energy-mcp-server":{"url":"https://eia-energy.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"eia-energy-mcp-server":{"type":"http","url":"https://eia-energy.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add eia-energy-mcp-server https://eia-energy.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"eia-energy-mcp-server","server_url":"https://eia-energy.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"eia-energy-mcp-server","server_url":"https://eia-energy.caseyjhand.com/mcp"}

Tools

• eia_browse_routes Browses the web · ~302 tokens
  Lists child routes under a given path in the EIA dataset taxonomy. Start with no path to get the 14 top-level categories (electricity, petroleum, natural-gas, steo, aeo, ieo, seds, etc.), then drill into subcategories. Each result includes an isLeaf flag — leaf routes are queryable endpoints; non-le
• eia_dataframe_describe ~310 tokens
  List canvas dataframes (df_<id>) materialized by eia_query_route calls that passed stage: true, with provenance, expiry, row count, and column schema. Nothing is staged until such a call runs, so an empty list on a fresh session means no query has staged yet, not that staging failed. Drops entries f
• eia_dataframe_query ~788 tokens
  Run a single-statement SELECT against canvas dataframes registered by eia_query_route calls that passed stage: true — a query that staged nothing leaves no table to select from. Standard DuckDB SQL — joins, aggregates, window functions, CTEs all supported. Reference dataframes by the df_<id> handles
• eia_describe_route ~722 tokens
  Returns metadata for a leaf route: available facets with their valid values, data column names and units, frequency options, and date range. Call this before eia_query_route to discover valid facet IDs, facet values, column IDs, and frequency codes. Each facet returns a capped window of its values w
• eia_query_route ~1350 tokens
  Fetches data from a leaf route with optional facet filters, date range, frequency, and column selection. Use eia_describe_route first to discover valid facet IDs, facet values, column IDs, and frequency codes. Data values are strings in the response (EIA API returns all numeric values as strings, e.
• eia_search_routes ~773 tokens
  Fuzzy text search across route names, descriptions, and category labels. Resolves natural-language queries like "electricity retail sales by state" or "natural gas imports" to matching route paths. Multi-term queries are also matched term by term, so combining a commodity, a metric, and a sector — "

Browse

• GitHub tools
• Pragma tools
• GitHub and code hosting
• Databases

Related MCP servers

• Eia
  EIA MCP — US Energy Information Administration API v2
• Eu Energy Imports
  EU energy imports MCP -- where Germany and each EU country get their gas, oil and coal, how much…
• Citiview Agent Market
  186 pay-per-call tools: search, LLMs, UK KYB, FRED, Census, maps, crypto. x402 USDC.
• exascale.build
  US ISO interconnection queues and cited energy data. 25 free queries, then $49/mo or $490/yr.
• Neso
  NESO MCP — Great Britain electricity grid open data (api.neso.energy)
• Theaslangroupllc Pulsenetwork
  914 paid market-data & token-safety endpoints — keyless x402 USDC: Base, Solana, XRPL, +8 chains
• Energy Charts
  Energy-Charts (Fraunhofer ISE) MCP — European electricity generation, prices, and capacity.…
• Carbon
  Carbon MCP — UK Carbon Intensity API (free, no auth)

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/eia-energy-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/eia-energy-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents