nectar-mcp
MCP server for the Nectar Climate utility data API (v2).
Exposes utility bill parsing, meter data, and ENERGY STAR Portfolio Manager export as MCP tools.
Tools
| Tool | Description |
|---|---|
list_sites |
List all sites/properties, optionally filtered by company |
get_site_usage |
Energy consumption data for a site over a date range |
get_meters |
All meters (utility accounts) for a site |
get_meter_usage |
Usage data for a specific meter with demand/supply breakdown |
get_bills |
Parsed utility bills (documents) for a site |
submit_bills |
Upload a PDF utility bill for OCR parsing |
export_to_energy_star |
Push data to ENERGY STAR Portfolio Manager |
get_interval_data |
High-resolution interval data for a utility connection |
Auth
Set your Nectar API key as a Bearer token in the Authorization header:
Authorization: Bearer <your-nectar-api-key>
The server forwards this as an X-API-Key header to the Nectar API.
Running locally
npm install
npm run dev # development (tsx)
npm run build # compile TypeScript
npm start # run compiled output
Deploy to Railway
railway link # link to your Railway project
railway up # deploy
MCP endpoint
POST /mcp
Stateless streamable HTTP transport. No session management required.
Health check
GET /health
Returns {"status":"ok","service":"nectar-mcp"}.
