# GridStatus MCP for AI Agents AI Agent Connect > GridStatus MCP gives your agent direct access to real-time and historical US electricity grid data. You can pull load demand, fuel mix, and wholesale pricing across all major ISOs like ERCOT, CAISO, and PJM. It is the go-to for anyone needing live market intelligence on the American energy landscape. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_QZdilZJ3ogM2jFYYhOsmNkFYk5HUldyuJL5xVoRu/ai-agent-connect - **Tags:** electricity-grid, iso-data, renewable-energy, wholesale-pricing, energy-market, real-time-monitoring ## Description This Connector turns your AI agent into a power grid analyst. Instead of jumping between tabs to find out how much solar is being generated in California or what the current wholesale price is in Texas, you just ask your agent to pull the data. It connects directly to the GridStatus API, letting you grab everything from 5-minute interval pricing to long-term capacity commitments. You can see exactly how much load a region is carrying or identify which fuels are powering the grid at any given moment. It handles the heavy lifting of querying different Independent System Operators, providing a unified way to look at the energy transition across the country. Whether you are tracking price spikes for arbitrage or looking at historical trends to model renewable adoption, this tool puts the raw data in your hands. It is one of the easiest ways to bring industrial-grade energy market intelligence into your daily workflow through the Vinkius catalog. ## Tools ### get_api_usage Check your current row counts and remaining API quota. It helps you stay within your plan limits while querying data. ### get_capacity_data Retrieve long-term resource adequacy and capacity commitments for a US ISO. Use this for multi-year planning. ### get_dataset_metadata See the date ranges and columns available for a specific dataset. This lets you verify what data exists before you run a query. ### get_fuel_mix Get a breakdown of electricity generation by source like wind, solar, or coal. It is perfect for tracking the renewable energy transition. ### get_lmp_data Fetch day-ahead Locational Marginal Pricing for various ISOs. This helps you see forecasted wholesale prices at specific trading hubs. ### list_datasets See every available dataset provided by the GridStatus API. Use this to find the right data identifiers for different regions. ### get_load_data Pull real-time and historical electricity demand for any major US ISO. This shows you exactly how much power a region is consuming. ### query_dataset Run custom queries with filters, resampling, and aggregation on any dataset. This is your go-to for complex analysis. ### get_realtime_lmp Get the most granular 5-minute interval pricing data available. Use this to track live price spikes and market volatility. ### get_realtime_spp Access real-time 15-minute Settlement Point Prices for the Texas grid. It is essential for monitoring live ERCOT hub prices. ### get_spp_data Get day-ahead hourly SPP data for the ERCOT market. This provides specific pricing for Texas trading hubs and load zones. ### get_standardized_data Fetch hourly data with a uniform schema across different regions. This makes it much easier to compare data between different ISOs. ## Prompt Examples **Prompt:** ``` What is the current load in the PJM region? ``` **Response:** ``` ### Current PJM Load | Metric | Value | | :--- | :--- | | **Current Demand** | 64,210 MW | | **Trend** | +2% from last hour | | **Status** | Stable | *Note: Load is currently within normal operating parameters for this time of day.* ``` **Prompt:** ``` How much solar power is California using right now? ``` **Response:** ``` ### CAISO Fuel Mix Breakdown * **Solar:** 8,245 MW (32%) * **Natural Gas:** 9,870 MW (38%) * **Wind:** 4,120 MW (16%) * **Hydro:** 1,890 MW (7%) * **Nuclear:** 2,215 MW (9%) **Total Renewables:** 55% of current generation. ``` **Prompt:** ``` Give me the day-ahead prices for the Houston hub tomorrow. ``` **Response:** ``` ### ERCOT SPP Day-Ahead Forecast (Houston Hub) | Time | Price ($/MWh) | | :--- | :--- | | 03:00 | $18.50 | | 08:00 | $24.10 | | 12:00 | $31.00 | | 18:00 | $42.20 | *Prices are currently trending higher than the previous week.* ``` ## Capabilities ### Pull real-time electricity demand Get current and historical load data for any major US ISO region. ### Break down power generation sources See the percentage of power coming from wind, solar, coal, and other fuels. ### Fetch day-ahead wholesale prices Retrieve hourly price forecasts for specific nodes and trading hubs. ### Track live 5-minute price volatility Monitor real-time price spikes at various ISO locations. ### Query Texas-specific SPP data Access 15-minute Settlement Point Prices for the ERCOT grid. ### Access capacity market data Retrieve long-term resource adequacy and commitment metrics. ### Explore available datasets List all available data types and check their metadata before querying. ### Check your API usage Monitor your row counts and remaining quota in real time. ## Use Cases ### Spotting Price Spikes A trader asks their agent to find 5-minute price spikes in the PJM region to decide when to sell power. The agent uses get_realtime_lmp to find the best moment. ### Siting New Solar Farms A developer uses the agent to check historical fuel mix and load data to find the best location for a new solar array. It uses get_fuel_mix to see historical trends. ### Policy Reporting A researcher asks for a yearly summary of coal vs. natural gas generation in the Midwest to write a report. The agent uses query_dataset to aggregate the data. ### Corporate Procurement A sustainability lead asks the agent to find the cheapest hours for renewable energy in the Northeast to lower company costs. The agent pulls data using get_lmp_data. ## Benefits - Stop manual data scraping by pulling load and generation data directly into your agent using get_load_data. - Identify arbitrage opportunities faster by checking real-time LMP and SPP prices instantly with get_realtime_lmp. - Track the renewable transition with specific fuel mix breakdowns for regions like California and Texas using get_fuel_mix. - Plan long-term projects with accurate capacity market and resource adequacy data using get_capacity_data. - Compare different ISOs easily using standardized zonal data with consistent schemas via get_standardized_data. - Manage your data limits proactively by checking your API usage and remaining quota with get_api_usage. ## How It Works The bottom line is you get instant, queryable access to the entire US electricity market without manual data scraping. 1. Subscribe to the GridStatus MCP on Vinkius and grab your API key. 2. Plug that key into your preferred AI client to authorize the connection. 3. Ask your agent for specific grid data, like 'What is the current load in PJM?' ## Frequently Asked Questions **Can the GridStatus MCP show me real-time electricity prices?** Yes, it provides 5-minute interval pricing for several major US ISOs. This helps you see live market volatility and price spikes as they happen. **Does GridStatus MCP cover all of Texas?** It provides specific data for the ERCOT grid, including Settlement Point Prices (SPP). You can see prices for various trading hubs and load zones across the state. **Can I use GridStatus MCP to see how much wind energy is being produced?** Yes, you can pull fuel mix data for regions like California and New England. It shows the percentage of power coming from wind, solar, and other sources. **Is there a way to compare different regions with GridStatus MCP?** You can use the standardized data tool to get consistent formatting for different ISOs. This makes it much easier to compare load and pricing across the country. **How do I check my API limits with GridStatus MCP?** You can ask your agent to check your usage. It will show you how many rows you've queried and how much of your monthly allowance remains. **Can GridStatus MCP help with long-term energy planning?** Yes, it includes capacity market data and resource adequacy metrics. This is useful for understanding long-term grid commitments and supply. **Which US electricity grid operators (ISOs) are supported?** The GridStatus API supports all major US Independent System Operators: ERCOT (Texas), CAISO (California), PJM (Mid-Atlantic/Midwest), MISO (Midwest), NYISO (New York), ISO-NE (New England), and SPP (Southwest/Central). Each ISO provides different datasets including load, fuel mix, LMP pricing, and standardized data depending on what they report. **How do I get a GridStatus API key and what are the usage limits?** Visit https://www.gridstatus.io/ and create a free account. Your API key will be available in your account settings. The free tier includes 500,000 rows per month, which is sufficient for most research and analysis use cases. Use the `get_api_usage` tool to monitor your remaining quota. Higher tiers are available for commercial applications requiring more data access. **What is the difference between LMP and SPP pricing data?** LMP (Locational Marginal Pricing) is used by most ISOs (PJM, CAISO, MISO, NYISO, ISO-NE, SPP) and represents the wholesale electricity price at specific nodes. SPP (Settlement Point Price) is ERCOT's equivalent for Texas. Both measure $/MWh but use different market mechanisms. LMP has day-ahead hourly and real-time 5-minute intervals. ERCOT SPP has day-ahead hourly and real-time 15-minute intervals. Both include prices at trading hubs (e.g. HB_HOUSTON, HB_NORTH), load zones, and resource zones. **Can I get renewable energy percentage data from the fuel mix?** Yes! Use the `get_fuel_mix` tool with ISOs that support it (ERCOT, CAISO, ISO-NE). The response includes generation breakdown by source: solar, wind, hydro, natural_gas, coal, nuclear, and others. You can calculate the renewable percentage by summing solar + wind + hydro and dividing by total generation. Note that fuel mix data availability varies by ISO — ERCOT and CAISO have the most comprehensive renewable tracking.