Ask the Grid

List every active OAuth grant on your Ask the Grid account, across all connected MCP clients and resources (per-market and global).

list_grants

List owned alert rules by lifecycle status. Use this to resolve an alert id before reading or changing it.

list_alerts

List the authenticated user's saved assets, map views, and stories, newest first, together with every portfolio on the account. Filter by kind, by portfolio, or by a free-text term over the label. Use this before manage_saved to get exact itemKeys and portfolio ids.

list_saved

Pause, resume, update, or archive one owned alert after the user explicitly requests that exact action. Resolve the alert id with list_alerts. For numeric updates, sanity-check changed thresholds against recent data. Archive is destructive; pause is reversible.

manage_alert

Measure one source→sink congestion path in one market: the constraints that move its basis, this week's outlook, and a hedge / instrument / ignore call at a stated MW size. Use exact settlement point ids from query_grid_assets.

get_congestion_path

Run one bounded read-only ClickHouse SELECT against exact dotted tables returned by search_data or describe_data. The server rejects unregistered and out-of-scope tables, and every table must belong to the given `iso`.

query_data

Read the operator briefings written over the wire: what changed in a closed time window, why it matters, and what to watch, with citations back to the publishers. Each briefing states its knowledge cutoff — it saw only stories collected before that instant. A briefing can report that nothing material happened; that is an answer, not an empty result.

get_wire_briefings

Enterprise: idempotently queue source-backed hydration for an existing grid asset. The request enters a reviewed publication workflow; it never publishes unreviewed research inline.

request_asset_hydration

Revoke one of your own OAuth grants by client id and resource. Call list_grants first to get the exact values.

revoke_grant

Find query-ready datasets in one market's catalog. Returns exact ClickHouse tables, grain, evidence class, and semantic query rules. Use describe_data for the selected dataset's full column schema before query_data.

search_data

Search or resolve plants, zones, price nodes, substations, and transmission lines in one market. Provide exactly one of query or id. Copy a returned id unchanged into later tools; an LZ_* price target may correctly be a node:* id.

query_grid_assets

Search collected US grid, market, and regulatory news, newest first. Covers ~225 publishers, ISO newsrooms, utilities and regulators. Optionally scope to one market (e.g. `ercot`, `pjm`) or sector (e.g. `data-centers`, `battery-storage`). Returns the publisher's canonical URL for every story — cite that, not this tool. Article bodies are never stored and never returned.

search_wire

Grid Radar findings and grid events reaching the user's saved assets, or one portfolio's, each with the assets it reaches and how: direct (names the asset or its settlement point), priced (a constraint's $/MWh effect at the asset's own node, by shift factor), located (hub, zone, county or distance), technology, or market-wide. Includes findings on the assets' own settlement point prices. Pass asOf to replay a past instant within 30 days.

get_saved_findings