Tools

Everything InfraMap exposes to your AI client: tools, resources and prompts.

40 capabilities40 tool

Automated heuristic

Tool docs quality: B — 40 tools graded

Average 71/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.

Grade A: 6
Grade B: 28
Grade C: 5
Grade D: 1
Grade F: 0

How grades work

analyze_battery_periodtool
Analyze ERCOT battery operations. Battery operations over up to 24 months for up to 5 plants, with the two metering regimes kept apart.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
analyze_market_periodtool
Analyze a market period. Prices, basis and coverage for up to 5 projects over up to 12 months in any of the seven markets.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
assess_capture_rate_coveragetool
Check capture rate coverage. Checks whether exact capture rates can be computed for a project, and what is missing.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
compare_project_curtailmenttool
Compare modeled curtailment. Screen or compare modeled curtailment across the full eligible cohort between matched month windows, nationally or by ISO, state or technology.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
discover_energy_datatool
Find datasets. Search datasets by research terms, or inspect one dataset ID for meaning, grain, join rules and coverage.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
explain_analysis_limittool
Explain an analysis limit. Explains a known gap, the inputs it would need and the closest supported alternative.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_analysis_guidetool
Get analysis guide. Reviewed terminology, formulas, study checklists and primary references for study design.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_data_catalogtool
Inspect the data catalog. Every approved data source with its as-of date, coverage, tools and limits. Call it first.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_data_coveragetool
Get data coverage. What InfraMap holds now for each market dataset, ISO and product: first and latest day, missing days, the longest gap, last write and backfill progress, with source, licence and units.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_energy_referencetool
Look up energy definitions. Reviewed definitions, formulas, guards and primary references for energy terms and study topics such as capacity factor, basis, capture rate, ELCC and curtailment.
Description quality grade B, 80/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: passed10/10
  Includes when or how to use it.
get_eqr_hourly_salestool
Get FERC EQR hourly sales. Seller-reported hourly sales by delivery point for about 430 plants in 2026 Q2. Reported sales, not metered generation.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_ercot_project_datatool
Get ERCOT project data. ERCOT resource net energy (SMNE), node and hub settlement point prices and basis for one month.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_grid_topologytool
Get grid network coverage. Public OpenStreetMap network coverage and per-project USGS and OSM geometry counts.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_live_pricestool
Get live 5-minute prices. The newest 5-minute real-time prices at every hub and zone, or at every pricing node ranked highest or lowest (view nodes, Pro), or up to 8 days at one hub or 2 days at a plant's pricing node, or hourly real-time a
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_battery_operationstool
Get ERCOT battery operations. Battery resource coverage or one month of operational energy.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_detailstool
Get generator and plant details. Generator and plant fields for exact EIA plant IDs, with generator paging.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_emissionstool
Get project emissions. Annual EPA CO₂, SO₂ and NOx mass for monitored units, linked through the PUDL CAMD–EIA crosswalk. US short tons.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_evidence_bundletool
Get project evidence bundle. Compact verified evidence and yearly summaries for up to 5 projects and 60 months, by section.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_generationtool
Get project generation. EIA-923 monthly net MWh, with battery charging and discharging kept separate.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_generation_potentialtool
Compare generation with modeled potential. Actual generation beside reviewed physical potential and retrospective expected generation.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_grid_membershiptool
Get project grid membership. Dated unit-level balancing-authority relationships for one project, including reviewed transitions.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_market_pricestool
Get project market prices. Node coverage or one month of price statistics for a plant outside ERCOT (CAISO, ISO-NE, MISO, NYISO, PJM, SPP).
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_modeled_curtailmenttool
Get modeled curtailment. Monthly modeled curtailed MWh, expected curtailed hours and physical potential for one plant and year.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_ownershiptool
Get project ownership. Dated ownership and offtake conclusions and reported generator relationships.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_performancetool
Get project performance. Complete-period generation, dated nameplate capacity factor, battery flows and utilization for up to 5 projects.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_profiletool
Get project profile. Dossier for up to 5 projects: identity, capacity, region, pricing node and hub, earlier nodes from price chains, recent generation and capacity factor, ownership, offtake and 2024–2025 price and basis.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_project_source_coveragetool
Get project source coverage. Which source datasets hold records for a project, with the native IDs to query them.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_regional_curtailment_historytool
Get operator curtailment history. Operator-published regional curtailment: CAISO 2015–2025 and SPP 2024–2025.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_source_catalogtool
List loaded source datasets. Loaded source tables (water, boiler fuel, utilities, gas operators, EQR contracts, modeled renewable profiles) with grain, fields and caveats.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
investigate_project_curtailmenttool
Investigate modeled curtailment. Hour-level investigation for up to 5 plants over at most 366 days: loss blocks, durations, price coincidence and seasonality.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
model_project_revenuetool
Model project energy revenue. Historical modeled energy revenue: monthly EIA net generation times the same month’s mean node price.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
query_analyst_storetool
Query the analyst store (SQL). Run one read-only SQLite SELECT over the analyst store to screen, rank, count or compare projects across the whole inventory. Returns up to 200 rows with the store version and table citations.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Marked read-only.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
query_source_recordstool
Query source records. Find exact entity IDs, then read compact records with units and citations.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
rank_capacity_factorstool
Rank wind capacity factors. Pick the largest wind projects by operating wind nameplate, then rank their capacity factors.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
rank_ercot_basistool
Rank ERCOT basis. Rank reviewed ERCOT projects by node minus hub price for one month, hub and market.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
rank_generation_changetool
Rank generation change. Rank reported net generation change between the same months of two years across the filtered fleet.
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
rank_source_recordstool
Rank source records. Rank all records at the dataset’s own grain before taking the top rows.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
resolve_grid_areastool
Resolve grid areas. Resolve an ISO, RTO or balancing-authority code, name or alias before filtering plants.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
search_energy_projectstool
Search power plants. Filter, rank and page the current operating EIA catalog by state, fuel, ISO, balancing authority, county, size and hybrid status. Hybrid components are grouped once.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
summarize_source_recordstool
Summarize source records. Totals and heat rates across every matching record for 1–5 entities and at most 60 months.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.