Skip to content
MCP server

Openei Urdb

MCP server exposing NREL's US electricity tariff database to AI agents for utility rate

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Openei Urdb

Openei Urdb is a freemium MCP server for energy and smart home. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/openei-urdb/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openei-urdb": {
      "url": "https://gateway.pipeworx.io/openei-urdb/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for higher usage.

Prices change. Check pipeworx.io before you buy.

Openei Urdb 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.

How AIPoweredBot checks servers