# EIA Full Access MCP for AI Agents MCP > EIA Full Access — U.S. Energy Intelligence provides direct access to deep federal energy data covering everything from crude oil and natural gas prices to electricity grid demand and coal reserves. It gathers over 34 specialized tools into one place, letting your AI client model complex cross-commodity market dynamics using official government metrics. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Tags:** energy-intelligence, petroleum-data, natural-gas, energy-forecasts, commodity-market, macro-energy ## Description This MCP gives you a single connection point for every major stream of U.S. energy data. Instead of jumping between dozens of federal databases to piece together an annual report, your agent pulls everything into one workflow. You can track the supply and demand balance for petroleum products while simultaneously comparing natural gas storage levels against projected electricity generation from state grids. For example, you don't have to manually compare WTI crude prices with Henry Hub spot pricing; your agent handles that comparison instantly. This means you move beyond simple data retrieval. You start modeling: how will a change in coal mine production affect the overall cost of power when natural gas is also fluctuating? The depth and breadth of this dataset—covering everything from state-level energy profiles (SEDS) to international forecasts (IEO)—make it the definitive resource. Vinkius hosts this MCP so that any AI client can access these complex data streams without needing separate API keys or integrations for every single commodity. ## Tools ### get_coal_production Retrieves data on coal production, broken down by specific state and mine type. ### get_mine_production Sources individual-level coal production figures from mining records (EIA-7A/MSHA-7000-2). ### get_coal_prices Provides market pricing for various coal ranks, including bituminous, subbituminous, lignite, and anthracite. ### get_coal_quality Gathers data on coal consumption metrics like heat content, sulfur levels, and ash percentages. ### get_coal_trade Tracks the movement of coal via imports and exports, detailing quantity and price by country. ### get_coal_reserves Reports on total available coal reserves, productive capacity, and current stocks. ### get_electricity_prices Gathers retail electricity prices by state and specific industry sector (EIA-826, EIA-861). ### get_power_generation Details electric power generation metrics by state, fuel source, and operational sector (EIA-923). ### get_grid_demand Provides real-time hourly or daily estimates of the total electricity demand across all major U.S. grid operators. ### get_state_electricity_profiles Accesses comprehensive data detailing the energy profile for individual states. ### get_generator_inventory Lists inventory information for over 100,000 operable generators across the United States (EIA-860). ### get_plant_generation Provides specific operational details on power plants, including net MWh generation and fuel consumption. ### get_natgas_prices Retrieves natural gas prices for key markets: Henry Hub, citygate, wellhead, industrial, and residential rates. ### get_natgas_summary Offers a high-level summary of the national natural gas balance: production, consumption, imports, exports, and storage changes. ### get_natgas_reserves Details proved reserves and exploration data specifically for natural gas resources. ### get_natgas_production Reports on total natural gas production, including gross withdrawals and marketed volumes. ### get_natgas_trade Tracks the flow of natural gas across borders via imports, exports, and major pipeline routes. ### get_natgas_storage Provides weekly data on underground natural gas storage levels, a critical market indicator. ### get_natgas_consumption Details natural gas consumption rates broken down by state and major consuming sector. ### get_short_term_outlook Pulls the STEO forecast, providing 18-month U.S. energy price and supply projections (data range: 1974–2027). ### get_annual_outlook Provides AEO data, offering long-term U.S. energy projections covering production, consumption, and prices over 30 years. ### get_international_outlook Delivers IEO forecasts, tracking global energy production, consumption, and emissions across various regions. ### get_international_data Provides country-level data on energy production, consumption, and emissions globally. ### get_petroleum_prices Gathers commodity prices for major petroleum products like WTI, Brent, gasoline, diesel, and heating oil. ### get_petroleum_summary Calculates the overall supply/demand balance for petroleum, including production, stocks, imports, and consumption (weekly status report). ### get_crude_production Reports on total U.S. crude oil production volumes and associated reserve data. ### get_refinery_operations Details refinery capacity utilization, current processing rates, and operational metrics. ### get_petroleum_trade Tracks the movement of petroleum products through international imports, exports, and pipelines. ### get_petroleum_stocks Provides current inventory levels for commercial stocks plus Strategic Petroleum Reserve data. ### get_petroleum_consumption Reports on petroleum sales and consumption, categorized by product type and end-use sector. ### get_crude_imports Details crude oil imports into the U.S., broken down by country, company, grade, and type. ### get_state_energy_data Provides historical state-level energy data (SEDS) from 1960 to present for production, consumption, and prices. ### get_total_energy Presents a comprehensive U.S. total energy overview (MER), covering stocks, trade, and pricing for all major sources. ### get_nuclear_outages Tracks the status of nuclear power plants by reporting on operational outages. ## Prompt Examples **Prompt:** ``` Can you generate a dashboard showing the price relationship between WTI crude oil and Henry Hub gas over the last five years? ``` **Response:** ``` **📊 Commodity Price Comparison (2019–2024)** | Metric | 2019 Avg | 2021 Peak | Current Q3 Estimate | | :--- | :---: | :---: | :---: | | WTI Crude Price | $58/bbl | $75/bbl | $72.10/bbl | | Henry Hub Gas Price | $2.90/MMBtu | $4.50/MMBtu | $3.15/MMBtu | *Note: Prices are based on the most recent available data for each commodity.* ``` **Prompt:** ``` What are the current U.S. grid demand estimates and how does that compare to total power plant generation? ``` **Response:** ``` **⚡ Current Grid Performance Snapshot** * **Estimated Grid Demand (Today):** 380 GW. * **Total Reported Power Generation:** 365 GW. * **Sources Breakdown:** Coal accounts for 15%, Natural Gas for 45%, and Renewables make up the remaining 40% of generation. The gap suggests potential supply constraints or underreporting in one sector. ``` **Prompt:** ``` How do international energy forecasts compare to the U.S. outlook for oil and gas? ``` **Response:** ``` **🌍 International vs. US Energy View** * **Global Outlook (IEO):** Predicts a slight dip in global crude demand next year, focusing on Asia's growing renewable capacity. * **US Short-Term Forecast (STEO):** Shows stable domestic natural gas pricing but predicts higher volatility for petroleum due to geopolitical factors. The U.S. remains resilient, but the gap between US supply and international growth is widening. ``` ## Capabilities ### Model Cross-Commodity Supply Balances Get a comprehensive overview of supply/demand dynamics across petroleum, natural gas, electricity, and coal. ### Analyze State-Level Energy Profiles Retrieve historical energy data for specific U.S. states, tracking production, consumption, and prices over decades. ### Forecast Long-Term Market Trends Run projections using models like STEO (18-month) and AEO (30-year) to anticipate energy price movements and supply changes. ### Track Infrastructure and Reserves Get detailed information on physical assets, including operational power plants, generator inventories, and proved natural gas reserves. ## Use Cases ### Analyzing Cross-Sector Price Risk A financial analyst asks their agent: 'How does the STEO forecast for Henry Hub natural gas prices compare to historical gasoline pricing?' The agent executes both `get_short_term_outlook` and `get_petroleum_prices`, returning a comparative analysis that highlights market risk. ### Preparing State Infrastructure Reports A state utility manager needs data for a major presentation. They ask the agent to pull 60 years of energy usage history, executing `get_state_energy_data` and comparing total consumption metrics across decades. ### Modeling Supply Chain Disruptions A logistics consultant needs to know how an unexpected decline in crude oil imports (`get_crude_imports`) impacts refinery capacity utilization (`get_refinery_operations`), allowing them to model immediate supply chain choke points. ### Assessing Global Energy Pivots A research firm wants a global view. They ask the agent for IEO data, comparing regional international energy projections (`get_international_outlook`) against current U.S. total energy metrics (`get_total_energy`). ## Benefits - You track the full lifecycle of a commodity query. Need to check current electricity prices (`get_electricity_prices`)? Then, compare that cost against the long-term outlook from `get_annual_outlook` in one run. - The MCP connects disparate data streams like natural gas storage levels (`get_natgas_storage`) and crude oil stocks (`get_petroleum_stocks`). You get a single view of market liquidity without manual cross-referencing. - Forget outdated models. Use `get_short_term_outlook` to forecast the next 18 months for energy prices, giving your reports predictive power instead of just historical data points. - Deep dives into regional specifics are easy. Run a query on state-level electricity profiles (`get_state_electricity_profiles`) and immediately compare those results against national consumption trends from `get_natgas_consumption`. - It simplifies the complexity of tracking physical assets. You can quickly check which power plants are offline using `get_nuclear_outages`, while simultaneously reviewing total generation data via `get_power_generation`. ## How It Works The bottom line is you ask one complex question, and the MCP gathers all the necessary federal energy statistics to answer it. 1. Your AI client sends a query—for instance, 'Compare Q3 crude imports to the current electricity grid demand.' 2. The MCP routes the request internally, invoking multiple specific tools (like `get_crude_imports` and `get_grid_demand`) to gather disparate data points. 3. It returns a single, synthesized result set that includes all required metrics—the import figures, the current grid demand, and any necessary context for comparison. ## Frequently Asked Questions **How can I use EIA Full Access — U.S. Energy Intelligence to compare state-by-state energy consumption?** You can pull historical records for any given state using the `get_state_energy_data` tool. This lets you track how a single state's total energy needs have changed over decades, helping you model growth or decline in specific sectors. **I need to forecast prices; can EIA Full Access — U.S. Energy Intelligence help with long-term projections?** Yes. You can access both 18-month forecasts via `get_short_term_outlook` for immediate price predictions, or use the `get_annual_outlook` tool for a more generalized view of energy market trends over the next three decades. **Does EIA Full Access — U.S. Energy Intelligence cover all types of fuel sources?** Absolutely. It covers petroleum (WTI, Brent), natural gas (Henry Hub), electricity generation (from coal, gas, hydro), and coal-specific metrics like quality and reserves. **Is EIA Full Access — U.S. Energy Intelligence useful for international comparisons?** Yes. Beyond US data, you can pull global figures using the `get_international_outlook` tool to see how world energy production and consumption compare to domestic trends. **How do I find out about refinery capacity or crude oil imports?** You use dedicated tools for that. The `get_refinery_operations` function gives you utilization rates, while `get_crude_imports` breaks down exactly where your raw materials are coming from country by country. **Can EIA Full Access — U.S. Energy Intelligence model the whole energy picture?** Yes. It's designed to synthesize the entire market, allowing you to connect inputs like total production (`get_total_energy`) with consumption metrics across all sectors and fuels.