ZBS Index What actually exists in applied AI, with the source next to it

mcp server

eia-energy-mcp-server

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

Description as published by the maintainer. Source

  • version 0.4.0
  • active

active — Most recent push to the repository was 2026-08-06.

What this server can do

6 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

eia_browse_routes(path)
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-leaf routes have children to browse. When isLeaf is true on the browsed path itself, switch to eia_describe_route.
eia_dataframe_describe(name)
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 for dataframes the canvas no longer holds before responding, so the list is always current. Pass a specific name to inspect one dataframe; omit to list all active dataframes for this tenant. A name that is not staged comes back as found=false alongside the handles that are, never as an empty list. Listing is not use: only an eia_dataframe_query statement naming a dataframe extends its expiry, so a dataframe polled with this tool and never queried still lapses on schedule.
eia_dataframe_query(sql, preview, row_limit, register_as)
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 returned by eia_query_route or listed by eia_dataframe_describe. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, and external-file table functions are rejected. System catalogs (information_schema, pg_catalog, sqlite_master, duckdb_*) are denied. EIA data values are VARCHAR — use CAST(col AS DOUBLE) for arithmetic and aggregation. Optional register_as chains results as a new dataframe with a fresh expiry. Every dataframe named in the statement has its expiry extended by the query. Required: sql.
eia_describe_route(facet, route, values_offset)
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 with value_count and values_truncated alongside; pass facet and values_offset to page through the rest of one facet. A values_offset past the last value of a facet returns an empty window for it and a notice naming the count to page against. Facet values are fetched from separate EIA endpoints and merged — results are cached per-route for the process lifetime to minimize API calls. Required: route.
eia_query_route(end, sort, route, stage, start, length, offset, columns, filters, frequency)
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.g. "9.13"); cast to DOUBLE in SQL when arithmetic is needed. Returns a preview inline and stages nothing by default — one upstream request, whatever total says. Pass stage: true to also page past the preview and stage the accumulated set as a DataCanvas table, then pass the returned dataset name to eia_dataframe_query for SQL. Every dataset a tenant stages lands in the same canvas, so tables from different routes cross-join by name with nothing to thread between calls. Required: route.
eia_search_routes(limit, query)
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 — "electricity price residential", "coal generation industrial sector" — reaches the route carrying that data even when no single entry reads like the whole phrase. STEO series names are indexed so queries like "ethanol net imports" or "crude oil production forecast" also resolve, and so are facet values, so a fuel type or sector term like "wind" or "anthracite coal" resolves to the route that exposes it, with filter_hint carrying the filter to pass on. Results include isLeaf so you know whether to browse further or query directly. Results with score > 0.72 are weak matches — try a more specific query or use eia_browse_routes to explore the taxonomy. The first call after server start waits 24-30s while the index warms, and at most 45s; every later call returns in milliseconds. Check indexComplete before reading anything into a short or empty result set. Required: query.

Last successful function declaration observed on . Source: https://eia-energy.caseyjhand.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on . Source: https://eia-energy.caseyjhand.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Signal Value What it measures Window Observed Source
GitHub stars 2 Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. cumulative, all time GitHub
Last commit 2026-08-06 Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. point in time GitHub
Open issues 0 Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. as of fetch GitHub
Latest published version 0.4.0 Latest version string the maintainer published to the registry. as of fetch Model Context Protocol
Registry record last updated 2026-08-06 When the registry record was last updated by its maintainer. point in time Model Context Protocol
First listed in the MCP Registry 2026-08-06 Date this server was first published to the official MCP Registry. Not a usage or quality measure. point in time Model Context Protocol
repository status active The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. as of fetch GitHub
mcp tools declared 6 tools Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. as of probe eia-energy.caseyjhand.com
mcp endpoint status ok The server listed 6 functions when asked. as of probe eia-energy.caseyjhand.com

Where to get it

Related, by what their authors tagged them

  • io.github.cyanheads/eia-mcp-server — last commit 2026-08-06, shares bun, coal, cyanheads
    Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.
  • petromcp — last commit 2026-08-03, shares petroleum
    Local-first MCP server: read LAS well logs and DLIS files from your own disk.
  • Gridbert — last commit 2026-08-06, shares electricity
    Austrian energy data: 100+ electricity tariffs daily, grid fees, subsidies, bill analysis.
  • io.github.cbetz/ratebook — last commit 2026-07-01, shares electricity
    Open MCP server for US electricity tariffs: real rate lookup, bill estimates, and when to charge.
  • io.github.cyanheads/attack-surface-mcp-server — last commit 2026-07-30, shares bun, cyanheads
    Passive external attack-surface mapping: CT subdomains, DNS, TLS, HTTP posture, RDAP/WHOIS, Shodan.
  • io.github.cyanheads/biorxiv-mcp-server — last commit 2026-07-11, shares bun, cyanheads
    Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP.
  • io.github.cyanheads/bls-labor-mcp-server — last commit 2026-07-17, shares bun, cyanheads
    Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
  • io.github.cyanheads/bls-mcp-server — last commit 2026-07-17, shares bun, cyanheads
    Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
  • io.github.cyanheads/crossref-mcp-server — last commit 2026-07-13, shares bun, cyanheads
    Resolve DOIs, search ~155M scholarly works, and fetch references via the Crossref REST API.
  • io.github.cyanheads/earthquake-mcp-server — last commit 2026-07-30, shares bun, cyanheads
    Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.

These share tags the maintainers applied themselves, such as bun, coal, cyanheads, eia. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

Also from cyanheads

How the author describes it

Topics the maintainer set on GitHub: ai-agent, bun, coal, cyanheads, eia, electricity, energy-api, energy-data, mcp, mcp-server, model-context-protocol, natural-gas, petroleum, steo, typescript, us-energy.

This record as data

Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.

GET /api/v1/entries/mcp_server.json

Sources

  1. cyanheads/eia-energy-mcp-server on GitHub — GitHub, observed , trust tier 3.
  2. Tools declared by the MCP server at https://eia-energy.caseyjhand.com/mcp — eia-energy.caseyjhand.com, observed , trust tier 4.
  3. Official MCP Registry — Model Context Protocol, observed , trust tier 1.