arcadia-mcp

MCP server for the Arcadia Arc utility data API.

Connects to 7,000+ utilities to surface bill data, interval meter readings, and carbon calculations via the Model Context Protocol.

Tools

Related MCP server: bank-mcp

Usage

Auth

Pass your Arcadia API key as a Bearer token in the Authorization header of every MCP request:

Authorization: Bearer arc_live_...

MCP endpoint

POST /mcp

Health check

GET /health

Development

npm install
npm run dev       # tsx watch mode
npm run build     # tsc → dist/
npm start         # node dist/index.js

Set PORT env var to override the default port 3000.

Deployment

Deploy to Railway — the railway.toml configures build and start commands automatically.

Set the PORT environment variable if needed (Railway injects it automatically).

Carbon calculation

Uses EPA eGRID 2023 emission factors (lbs CO₂/MWh) for 20 US states. All other states default to 850 lbs CO₂/MWh (approximate US average). Returns both kgCO2e and lbsCO2.