india_grid_carbon_intensity
ClaudeUse this when a user asks for modelled hourly grid carbon intensity in gCO2/kWh for All India, a state, or a regional zone. Defaults to All India over 48 hours, computed as the generation-weighted mean of the state series, with each state's latest value. Windows over 120 hours are averaged into multi-hour blocks. Preserve the modelling basis and provenance.
india_grid_carbon_mix
ClaudeUse this when a user asks which generation fuels underlie the modelled carbon-intensity estimate, including coal, gas, hydro, nuclear, wind, solar and import shares, for All India (with each state's latest value) or one state. Windows over 48 hours are averaged into multi-hour blocks.
india_grid_catalog
ClaudeUse this when a user asks what India Energy Atlas data exists, or needs a dataset's cadence, status, scope and public sources before choosing a tool. Optionally filter by words in the dataset name, category or source.
india_grid_data_centre_market_bands
ClaudeUse this when a user wants a compact India-wide comparison of Data Centre screening bands for development potential, electricity demand, digital connectivity, water context, or industrial tariff. Returns only named city/state bands on a 1-5 scale (0 means Not reported), never map geometry, raw tariff schedules, or tracker inputs.
india_grid_data_centre_search
ClaudeUse this when a user names an Indian city, district, locality or other place and needs matching coordinates before screening Data Centre development potential. The place text is sent to the Mapbox geocoding service. Returns at most five India-only matches; pass one result to india_grid_data_centre_site_screen. Do not send street addresses or personal locations.
india_grid_data_centre_site_screen
ClaudeUse this when a user needs an early-stage Data Centre development screen for one coordinate inside India. Returns a 0-100 potential score, confidence, evidence-aware component scores for grid, demand, digital connectivity, water, industrial tariff, and ecosystem, plus an indicative industrial energy-charge range and nearby infrastructure. Coordinates outside India's land boundary are rejected. It is not proof of substation headroom, interconnection, a tariff bill, water allocation, land title, permits, or engineering feasibility.
india_grid_demand_accuracy
ClaudeUse this when a user asks how close India Energy Atlas modelled state demand is to official data. Scores the concurrent state-demand estimate against official SLDC 15-minute load over a lookback (MAPE, bias, percentile errors), per state and pooled across those states. It does not score the hourly forecast from india_grid_demand_forecast, and the pooled figure is not all-India.
india_grid_demand_forecast
ClaudeUse this when a user asks for an hourly electricity-demand forecast for Indian states or one state. horizon_hours defaults to 24 and cannot exceed 168. Without a state, every state is returned on one shared time axis with a sum of states; long horizons are averaged into multi-hour blocks and the result says so. Treat every value as modelled, not measured.
india_grid_demand_reconciliation
ClaudeUse this when a user asks for the stored modelled-versus-official electricity demand comparison per state for a 24h, 7d or 30d window. Rows are precomputed; the result gives computed_at, age_days and a stale flag, and stale rows must be described as historical. For a current comparison use india_grid_demand_accuracy.
india_grid_frequency
ClaudeUse this when a user asks for recent Indian grid frequency or frequency-band analysis. Returns up to 96 time buckets covering the whole window with mean, minimum and maximum hertz, plus a summary. The recent series is the mean of state load dispatch centre (SLDC) readings, labelled as such; implausible readings are removed first. It does not operate or control the grid.
india_grid_iex_area_prices
ClaudeUse this when a user asks how IEX Day-Ahead Market prices differed between bidding areas. Returns per-area divergence statistics for the whole window and the 15-minute blocks where an area's price split from the national price. Supply date as YYYY-MM-DD for one day, or use days for a lookback window.
india_grid_iex_heatmap
ClaudeUse this when a user wants an hour-by-day view of recent IEX Day-Ahead Market prices to identify peak, off-peak, and temporal patterns. Returns a date x hour grid of mean prices (weeks x hour for windows over 45 days) plus an hourly profile. Do not use it to place or recommend a trade.
india_grid_iex_price_duration
ClaudeUse this when a user asks what share of recent IEX Day-Ahead Market blocks were above each price level. Returns the whole price-duration curve at every 1% of exceedance plus the share of blocks at or above fixed price tiers. Descriptive only; not investment advice.
india_grid_live_snapshot
ClaudeUse this when a user asks for the latest, or a specified historical, 15-minute snapshot of electricity demand across Indian states and All India. Returns per-state demand in MW, the source type (official or modelled), official frequency readings, and the share of states with an official reading. It does not return generation or prices.
india_grid_open_access
ClaudeUse this when a user asks for published open-access electricity charges by state, including cross-subsidy, additional, transmission, wheeling and scheduling charges and losses. Verify effective dates and source documents before using the result commercially.
india_grid_posoco_psp
ClaudeUse this when a user asks for Grid-India (formerly POSOCO) daily Power Supply Position data: peak demand, energy met, shortage and frequency by region or state. By default returns the latest published day. With days, returns a daily series for the state or region given, or the All India series if neither is given.
india_grid_state_detail
ClaudeUse this when a user asks for one Indian state's energy profile: latest demand and its source type, monthly official peak and energy summary, installed capacity, mapped transmission network counts and caveats. Accepts a state name or slug in any case.
india_grid_states
ClaudeUse this when a user needs the Indian states and union territories covered by India Energy Atlas. Returns each slug, name, grid region and transmission-network mapping status. Any state argument in the other tools accepts either the slug or the name.