# Openei Urdb

> Openei Urdb is a freemium MCP server for energy and smart home. MCP server exposing NREL's US electricity tariff database to AI agents for utility rate. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web
- **Website:** https://pipeworx.io/packs/openei-urdb
- **Repository:** https://github.com/pipeworx-io/mcp-openei-urdb
- **MCP Registry name:** io.github.pipeworx-io/openei-urdb
- **Categories:** [energy and smart home](https://ai-powered.com/categories/energy-and-smart-home)
- **Listing updated:** 2026-11-18

## About

The README describes this server as a bridge to NREL's Utility Rate Database, which holds US electricity tariffs for residential, commercial and industrial customers. Through it, an AI client can search rate schedules by address, coordinates, utility name or EIA id, and pull the full structure of a single tariff, including energy charges by tier, time-of-use periods, demand charges and fixed monthly charges.

The README notes that the upstream database keeps superseded tariffs as well as current ones, and that a rate's activity status is flagged in results. It also warns that Texas retail-choice tariffs are largely missing, so location searches there can come back empty. The endpoint is hosted by Pipeworx and works anonymously at a low daily cap, with an optional free key for a higher one.

The server is aimed at developers and analysts building bill calculators, energy modelling or rate comparisons who want tariff data inside an agent workflow rather than a manual lookup.

## Features

- **Tariff search by location:** Finds electricity rate schedules by address, latitude and longitude, utility name or EIA id, with optional sector filtering.
- **Full tariff structure:** Returns energy tiers, time-of-use period schedules, demand charges and fixed monthly charges for one rate label.
- **Utility lookup:** Lists which utilities serve a location, with tariff counts and how many of those tariffs are current.
- **Active versus superseded flags:** Marks whether a tariff is still in effect, since the upstream database retains historical rate schedules.
- **Hosted or local connection:** Runs as a remote streamable-HTTP endpoint or as a local npm stdio bridge to the same gateway.

## Good for

- Estimating an electricity bill for a given home or facility under a specific utility tariff
- Comparing residential or commercial rate schedules across utilities in a region
- Feeding time-of-use and demand charge structures into energy modelling or solar payback analysis
- Checking whether a utility's tariffs in the NREL database are still active

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openei-urdb https://gateway.pipeworx.io/openei-urdb/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/openei-urdb/mcp
```

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

```json
{
  "mcpServers": {
    "openei-urdb": {
      "url": "https://gateway.pipeworx.io/openei-urdb/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "openei-urdb": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openei-urdb/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openei-urdb": {
      "serverUrl": "https://gateway.pipeworx.io/openei-urdb/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openei-urdb": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openei-urdb/mcp"
    }
  }
}
```

## Tools

- `urdb_search_rates`: Search US electricity tariffs by address, coordinates, utility or EIA id.
- `urdb_rate_detail`: Get the full structure of one tariff by its URDB label, including period schedules.
- `urdb_utilities_for_location`: Find which electric utilities serve a US location, with tariff counts.

## FAQ

### Does the server need an API key?

No. The README says it works anonymously at a low daily cap. A free Pipeworx key raises the cap to 200 calls a day, and the upstream NREL key is optional.

### Why might a location search return no rates?

The README says Texas retail-choice tariffs are largely absent from the URDB, so searches for Houston return zero rates by both coordinates and ZIP code.

### Does the database include tariffs that are no longer in effect?

Yes. URDB keeps superseded tariffs, and the tools flag them through an is_active field and warn when all results are superseded.

### Which MCP clients can connect?

The pack page lists setup for Cursor, VS Code, Claude.ai custom connectors, Claude Desktop and Claude Code, using the mcp-remote bridge or direct URL.

### Is Openei Urdb free?

Openei Urdb has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Openei Urdb to Claude Code?

Run this command in your terminal: claude mcp add --transport http openei-urdb https://gateway.pipeworx.io/openei-urdb/mcp

### What are the best alternatives to Openei Urdb?

The closest alternatives to Openei Urdb are Entso E, FindEnergyRates Electricity Rates, GridPulse: U.S. Energy Data, Electricity Maps and Ferc Form1.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Entso E](https://ai-powered.com/mcp/entso-e): Entso E is a freemium MCP server for energy and smart home.
- [FindEnergyRates Electricity Rates](https://ai-powered.com/mcp/findenergyrates-electricity-rates): FindEnergyRates Electricity Rates is a free MCP server for energy and smart home.
- [GridPulse: U.S. Energy Data](https://ai-powered.com/mcp/gridpulse-u-s-energy-data): GridPulse: U.S. Energy Data is a freemium MCP server for energy and smart home.
- [Electricity Maps](https://ai-powered.com/mcp/electricity-maps): Electricity Maps is a freemium MCP server for maps and travel.
- [Ferc Form1](https://ai-powered.com/mcp/ferc-form1): Ferc Form1 is a freemium MCP server for energy and smart home.
- [TexasHomeBills — Texas electricity plans](https://ai-powered.com/mcp/texashomebills-texas-electricity-plans): TexasHomeBills — Texas electricity plans is a freemium MCP server for energy and smart home.

---
Source: https://ai-powered.com/mcp/openei-urdb
