Available tools
23 tools| Tool | Description |
|---|---|
getRoutes | Get available routes for a dataset or list all top-level routes. Discover available datasets and their structure. Call with no arguments to see all top-level categories (electricity, natural-gas, petroleum, coal, etc.). |
getData | Get data from any dataset route with filtering and pagination. Supports date ranges (start/end), facets for filtering, frequency (annual/monthly/quarterly/daily), sorting, and pagination (length/offset). This is the universal data retrieval function. |
getFacets | Get available filter options (facets) for a dataset. Discover what filters are available for a specific dataset before querying. Returns facet names and their descriptions. |
getFacetDetails | Get available values for a specific facet. See all possible filter values for a particular facet (e.g., state IDs, sector codes, fuel types). Essential for building accurate filtered queries. |
getElectricityData | Convenience function for electricity datasets including retail-sales, facility-fuel, operating-generator-capacity, state-electricity-profiles, and electric-power-operational-data. Simplifies electricity data queries. |
getNaturalGasData | Convenience function for natural gas datasets including summary, storage (underground/LNG), production, consumption, imports/exports, and price data. Supports nested routes for detailed categories. |
getCoalData | Convenience function for coal datasets including aggregate-production, consumption-and-quality, exports, imports, mine-production, price, shipments, and stocks data. |
getPetroleumData | Convenience function for petroleum datasets including crude-oil-imports, crude-oil-production, exports, imports, prices, product-supplied, refinery-operations, reserves, and weekly stocks data. |
getSTEOData | Get Short-Term Energy Outlook (STEO) data for near-term energy market forecasts and projections. Covers prices, supply, demand, and consumption projections for all major energy sources. |
getAEOData | Get Annual Energy Outlook (AEO) data for long-term energy projections (25+ years). Includes reference cases and alternative scenarios for comprehensive energy planning. |
getIEOData | Get International Energy Outlook (IEO) data for global energy projections. Covers international energy consumption, production, and trade by region and fuel type. |
getSEDSData | Get State Energy Data System (SEDS) data for state-level energy statistics. Comprehensive state-by-state energy production, consumption, prices, and expenditures. |
getTotalEnergyData | Get Total Energy data for overall U.S. energy statistics. Monthly and annual energy production, consumption, imports, exports, and stocks across all energy sources. |
getCO2EmissionsData | Get CO2 Emissions data including aggregates by sector and fuel type, carbon coefficients, and emissions intensities. Essential for carbon footprint and sustainability analysis. |
getInternationalData | Get International energy data covering global energy statistics by country and region. Production, consumption, reserves, and trade data for major energy sources worldwide. |
getNuclearOutagesData | Get Nuclear Outages data including facility-level outages, generator capacity factors, and U.S. nuclear aggregates. Track nuclear plant availability and maintenance schedules. |
searchGenerators | Search the U.S. generator inventory by state, fuel type, prime mover, balancing authority, operating status, and minimum nameplate capacity. Returns one row per generator with summer, winter, and nameplate MW, plus operating year and any planned retirement date. |
getPlantGeneration | Pull monthly net generation in MWh and fuel consumption (physical units and BTU) for a single plant, broken out by fuel type and prime mover. Supports monthly, quarterly, and annual frequencies. |
searchPlants | Get a plant-level view aggregated from generator-level data: total nameplate and net summer capacity, generator count, fuel and prime-mover mix, and balancing authority. Filter by state, fuel, BA, status, sector. Sorted by total MW descending. |
getRetirementSchedule | List generators with a planned retirement date set, sorted by earliest retirement first. Filter by state, fuel type, and target retirement year, useful for capacity replacement planning. |
getFuelMix | Get generation by fuel type for a state or national aggregate at a given month, quarter, or year. Routes to plant-level facility-fuel data when state is set, or to operational aggregates otherwise. |
getServiceInfo | Reference metadata for the plant-level methods: supported routes, facet names, distinct enum values for status / sector / energy source / prime mover / balancing authority, date format, and pagination caps. Cached for 24 hours. |
Code Execution | Execute custom JavaScript/TypeScript code with full EIA connector access. Build complex queries, aggregate data across multiple datasets, perform calculations, create visualizations, and build custom workflows using all available EIA API methods. |
Setup
A few steps to connect your AI agents to EIA.
- 1
Create Your Account
Sign up for PatchOps to access our MCP server management platform.
- 2
Get EIA Access Key
Register for a free access key at https://www.eia.gov/opendata/ - it only takes a minute and is completely free.
- 3
Add EIA Credentials
Navigate to the Dashboard and add your EIA access key to establish the connection.
- 4
Configure Your AI Agent
Add the EIA MCP server URL to your AI agent's configuration file.
- 5
Start Querying
Begin asking your AI agent questions about U.S. energy statistics, market trends, and forecasts. Use the EIA MCP connector's structured methods for both standard queries and more advanced workflows.
Connect to your AI assistant
Pick the tool your team uses for the exact setup steps.
- 1
Open Claude settings
Launch Claude, click the profile button (bottom left), and go to Settings.
- 2
Access connectors
Open the Connectors tab, scroll to the bottom, and click “Add custom connector”.
- 3
Name your connector
Enter any name you’d like for this connector.
- 4
Get the connector URL
Log in to PatchOps, open the /mcp page, and copy the connector URL you want to use.
- 5
Add the connector
Paste the URL into the “Remote MCP server URL” box and click Add.
- 6
Start using
Your EIA connector is ready to use in Claude.