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
| Tool | Description |
|---|---|
list_utility_accounts |
List all connected utility accounts |
get_account |
Get details for a specific account (meters, status) |
get_bills |
Retrieve utility statements with optional date range |
get_interval_data |
High-resolution (15min/30min/hourly/daily) consumption for a meter |
get_meters |
List meters for an account |
calculate_carbon |
Estimate CO₂ emissions from kWh using EPA eGRID 2023 factors |
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.
