ENERGY STAR Portfolio Manager MCP Server

An MCP server that wraps the EPA ENERGY STAR Portfolio Manager REST API, enabling AI assistants to query and update building energy data.

Prerequisites

1. Portfolio Manager account — sign up at energystar.gov

2. Web Services access — enable in PM under Account Settings → Web Services

Related MCP server: emoncms-mcp-server

Authentication

The server uses HTTP Basic Auth forwarded to the EPA API. Encode your credentials:

const credentials = btoa('your_pm_username:your_pm_password')
// => e.g. "dXNlcm5hbWU6cGFzc3dvcmQ="

Pass as a Bearer token on every MCP request:

Authorization: Bearer dXNlcm5hbWU6cGFzc3dvcmQ=

Available Tools

Running locally

npm install
npm run dev        # tsx watch mode
# or
npm run build && npm start

Server runs on http://localhost:3000 by default. Override with PORT env var.

Deploying to Railway

railway login
railway init
railway up

Or use the one-liner after repo creation:

railway link <project-id> && railway up

Adding to Soapbox as a Connector

1. Deploy to Railway and copy the public URL (e.g. https://energy-star-mcp.up.railway.app)

2. In Soapbox admin, add a new MCP connector:

   • URL: https://energy-star-mcp.up.railway.app/mcp

   • Auth header: Authorization: Bearer <btoa(username:password)>

3. Assign to agents that need building energy data access

EPA API Reference

• PM Web Services documentation

• API test environment

• ENERGY STAR score methodology