# GridPulse: U.S. Energy Data

> GridPulse: U.S. Energy Data is a freemium MCP server for energy and smart home. Pay-per-call U.S. grid mix, power price and gas price data for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, self-hosted, macOS, Windows, Linux
- **Website:** https://noahs-mac-mini.tail571e99.ts.net
- **Repository:** https://github.com/noah-silver/gridpulse
- **MCP Registry name:** io.github.noah-silver/gridpulse
- **Categories:** energy and smart home, analytics and data
- **Listing updated:** 2026-11-16

## About

Data comes from the U.S. Energy Information Administration. Instead of an API key, each call is paid in USDC over the x402 protocol, on Algorand or Base, from a spending wallet you configure. The README advises using a small dedicated wallet, never a main one.

The MCP package exposes three tools: grid_mix, retail_electricity_price and henry_hub_gas_price. The wider HTTP API adds an x402 seller reliability check, seller search across the Bazaar, Algorand network health, account, asset and transaction explainers, and a crypto price cross-check, at roughly one to two cents per call.

A separate subscription plan offers hourly carbon intensity for 12 U.S. grid regions, Scope 2 factors and CSV export, with a free tier of 100 calls a day. The payment pages say it is not investment advice.

## Features

- **Grid generation mix:** Hourly MWh by fuel with renewable and carbon-free share for a balancing authority.
- **Retail electricity prices:** State and sector prices with year-over-year change and 12-month history.
- **Henry Hub gas price:** Daily spot price with 30-day average, range and history.
- **x402 payments:** Pays per call in USDC on Algorand or Base, no signup.
- **Seller checks:** Scores x402 sellers for reliability before you pay them.
- **One-click bundle:** Installs in Claude Desktop from an .mcpb file.

## Good for

- Add live U.S. power prices to an energy analysis
- Compare a state's retail rates by sector
- Track Henry Hub gas moves for a market summary
- Vet an x402 seller before an agent pays it

## Install

### Claude Code (Terminal)

```sh
claude mcp add gridpulse --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env ALGORAND_MNEMONIC='<ALGORAND_MNEMONIC>' -- npx -y https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "ALGORAND_MNEMONIC": "<ALGORAND_MNEMONIC>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "ALGORAND_MNEMONIC": "<ALGORAND_MNEMONIC>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gridpulse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "ALGORAND_MNEMONIC": "<ALGORAND_MNEMONIC>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "ALGORAND_MNEMONIC": "<ALGORAND_MNEMONIC>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "ALGORAND_MNEMONIC": "<ALGORAND_MNEMONIC>"
      }
    }
  }
}
```

## Tools

- `grid_mix`: Latest hourly U.S. generation mix for a grid region.
- `retail_electricity_price`: Average retail electricity price by state and sector.
- `henry_hub_gas_price`: Henry Hub natural gas spot price and history.

## FAQ

### What does a call cost?

The site lists $0.02 for grid mix, $0.01 for retail price and Henry Hub, with Algorand endpoints from $0.008.

### Do I need an API key?

No. Buyers pay per call via x402; the MCP server needs an optional wallet key.

### Where does the energy data come from?

The U.S. Energy Information Administration, which is public domain.

### Which regions are covered?

Balancing authorities such as ISO New England, PJM, ERCOT, CAISO, MISO, NYISO and SPP.

### Is GridPulse: U.S. Energy Data free?

GridPulse: U.S. Energy Data has a free plan, with paid plans for more usage or features.

### How do I add GridPulse: U.S. Energy Data to Claude Code?

Run this command in your terminal: claude mcp add gridpulse --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env ALGORAND_MNEMONIC='<ALGORAND_MNEMONIC>' -- npx -y https://github.com/noah-silver/gridpulse/releases/download/v1.0.1/gridpulse-mcp.mcpb

### What are the best alternatives to GridPulse: U.S. Energy Data?

The closest alternatives to GridPulse: U.S. Energy Data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/gridpulse-u-s-energy-data
