Skip to main content
Glama

gridpulse

Analyze home solar feasibility, electricity rates, time-of-use optimization, EV charging costs, and battery storage ROI using global grid intelligence from NREL, EIA, and Open-Meteo.

Instructions

GridPulse: Global energy grid intelligence API. NREL + EIA + Open-Meteo data synthesis. Home solar feasibility, electricity rate analysis, time-of-use optimization, EV charging cost modeling, battery storage ROI

Coverage: Global

Endpoints: • prices ($0.10): Electricity prices by state • grid ($0.10): Power grid status by region • renewable ($0.10): Renewable energy profile by state • natural-gas ($0.10): Henry Hub natural gas briefing • forecast ($0.10): 90-day energy forecast by state • ev-cost ($0.10): EV charging cost vs gasoline • solar ($0.10): Home solar feasibility analysis • appliance ($0.10): Home appliance energy cost calculator • battery ($0.10): Home battery storage analysis • carbon ($0.10): Household electricity carbon footprint • community-solar ($0.10): Community solar enrollment by ZIP code • tou ($0.10): Time-of-use rate optimization

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
actionYesWhich endpoint to call. Options: prices | grid | renewable | natural-gas | forecast | ev-cost | solar | appliance | battery | carbon | community-solar | tou
langNoResponse language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.)
stateNo2-letter US state code (TX, CA, NY, etc.)
regionNoercot | caiso | pjm | miso | isone | nyiso | spp
milesNoAnnual miles (1,000-100,000)
zipNoUS ZIP code (preferred)
system_kwNoSystem size in kW (2-20)
applianceNoAppliance type (hvac, water-heater, refrigerator, washer, dryer, dishwasher, lighting)
usage_hoursNoDaily usage hours (default varies by appliance)
age_yearsNoAppliance age in years (affects upgrade ROI calculation)
monthly_billNoAverage monthly electricity bill in USD
has_solarNotrue if existing or planned solar system
outage_priorityNoPriority for outage backup (essential-only, whole-home, ev-charging)
monthly_kwhNoAverage monthly electricity consumption in kWh
household_sizeNoNumber of people in household
credit_preferenceNoPreference for bill credit vs. direct payment programs
utilityNoUtility name (e.g., PGE, SCE, ConEd) for utility-specific TOU plans
has_evNotrue if household has an EV (major TOU savings driver)
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, description carries full burden. It lists endpoints and data sources but lacks details on safety (e.g., read-only), rate limits, or required permissions. Basic behavioral context is present but incomplete.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is front-loaded with core purpose and then systematically lists endpoints. Structure is clear and each line adds value, though the list format is somewhat verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 18 parameters and no output schema, the description provides a solid overview but lacks guidance on parameter combinations or expected results for each endpoint. Could be more complete with usage examples.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so description doesn't need to explain parameters. It adds no additional meaning beyond the schema; just lists endpoint names and one-line purposes.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states 'Global energy grid intelligence API' with explicit use cases (solar feasibility, rate analysis, EV costing) and lists 12 endpoints. Distinguishes from sibling 'pulse' tools by specifying the energy grid domain.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description implies use for energy-related queries but does not provide explicit when-to-use or when-not-to-use guidance relative to other pulse tools. No exclusions or alternatives mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GTCC777/pulsenetwork-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server