Skip to main content
Glama
soapboxbuild

nectar-mcp

by soapboxbuild

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

Related MCP server: md24de-mcp

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"}.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Unofficial MCP server for the messdienst24.de utility portal, providing tools to retrieve heating and hot-water consumption data, download PDF reports, and compare usage trends.
    3
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that wraps the EPA ENERGY STAR Portfolio Manager REST API, enabling AI assistants to query and update building energy data.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP server for the Arcadia Arc utility data API, enabling retrieval of bill data, interval meter readings, and carbon calculations.
    -