# EnergyAtIt API — Complete Reference for AI Agents

> Base URL: https://energyatit.com
> Auth: Bearer JWT or `eat_live_xxx` / `eat_test_xxx` API key in Authorization header
> Response format: { success: boolean, data?: any, error?: string, details?: any }
> MCP Server: 151 tools via Model Context Protocol
> REST API: 200+ endpoints across 121 route files

---

## What is EnergyAtIt?

EnergyAtIt is the operating system for energy infrastructure and data centers. It translates 17 industrial grid protocols into a single REST API and MCP tool surface, enabling real-time dispatch, carbon attestation with SHA-256 hash chains, demand response orchestration, compliance automation, fleet intelligence, and autonomous grid optimization.

Unlike facility-only optimizers focused on cooling or PUE, EnergyAtIt governs three time horizons: real-time operations (sub-100ms dispatch), near-term constraints (grid signals, LMP pricing, DR), and forward planning (10-year TCO, interconnection queues, procurement).

### Supported Protocols
Modbus TCP/RTU, SunSpec Modbus, IEC 61850 (ACSI + GOOSE), IEC 60870-5-104, ICCP/TASE.2, DNP3, IEEE 2030.5, BACnet/IP, SNMP, OpenADR 2.0b (VTN + VEN), OCPP 2.0.1, MQTT, CIM/CGMES, AMI/DLMS, plus northbound adapters for ABB Ability, Siemens MindSphere, Schneider EcoStruxure.

---

## Authentication

### Login
POST /api/auth/login
Body: { email: string, password: string }
Returns: { token, refreshToken, user: { id, email, role } }
Note: If 2FA enabled, returns { requires2FA: true } — then POST /api/auth/2fa/authenticate

### Register
POST /api/auth/register
Body: { email, password, name }
Password policy: 12+ chars, upper/lower/digit/special

### Refresh Token
POST /api/auth/refresh
Body: { refreshToken }

### Get Profile
GET /api/auth/me
Returns: user + tenant info (tenantId, tenantName, tenantSlug, memberRole)

### 2FA Setup
POST /api/auth/2fa/setup — Returns TOTP secret + QR code
POST /api/auth/2fa/verify — Verify TOTP token to enable 2FA
POST /api/auth/2fa/disable — Disable 2FA
POST /api/auth/2fa/authenticate — Authenticate with TOTP during login

### Password Management
POST /api/auth/forgot-password — Request reset email (always returns 200)
POST /api/auth/reset-password — Reset with token
POST /api/auth/change-password — Change password (authenticated)
PATCH /api/auth/profile — Update first_name, last_name

---

## Carbon Attestation

### Create Carbon Record
POST /api/v1/carbon/record
Body: { facilityId, meterId, kwh, source }
Returns: SHA-256 hash-chained attestation with auto-lookup of grid carbon intensity

### Batch Import
POST /api/v1/carbon/records/batch
Body: { records: [{ meterId, kwh, timestamp }] }

### Get Records
GET /api/v1/carbon/records/:facilityId

### Verify Hash Chain
GET /api/v1/carbon/verify/:meterId
Returns: chain integrity status with per-link verification

### Chain Health Status
GET /api/v1/carbon/chain-status/:meterId

### Facility Summary
GET /api/v1/carbon/summary/:facilityId

### Carbon Dashboard
GET /api/v1/carbon/dashboard/:facilityId

### Carbon Certificate
GET /api/v1/carbon/certificate/:facilityId
Query: ?format=json|pdf|csv
Returns: GHG Protocol Scope 2 certificate

### Verify Certificate
GET /api/v1/carbon/certificate/:certificateId/verify

### Transfer Certificate
POST /api/v1/carbon/transfer/:certificateId
Body: { toTenantId }

### Transfer History
GET /api/v1/carbon/transfers/:certificateId

---

## Carbon Marketplace

### List Listings
GET /api/v1/carbon-marketplace/listings

### Create Listing
POST /api/v1/carbon-marketplace/listings
Body: { certificateId, pricePerTonne, quantity }

### Purchase Credits
POST /api/v1/carbon-marketplace/purchase
Body: { listingId, quantity }
Includes: double-spend prevention

### Market Stats
GET /api/v1/carbon-marketplace/stats

### Search Credits
GET /api/v1/carbon-marketplace/search
Query: ?type, region, minPrice, maxPrice

---

## Scope 3 Emissions

### Generate Scope 3 Report
POST /api/v1/scope3/report
Body: { facilityId, periodStart, periodEnd }
Covers: 9 categories (Cat 1-7, 11, 13) with EPA/DEFRA emission factors

### Create Dispatch Attestation
POST /api/v1/scope3/dispatch-attestation
Links: dispatch commands to carbon attestation records

---

## Carbon Registry Bridge

### List Supported Registries
GET /api/v1/registry/registries
Returns: Verra, Gold Standard, I-REC, EnergyTag

### Submit to Registry
POST /api/v1/registry/submit
Body: { certificateId, registryId }

### Check Registration Status
GET /api/v1/registry/status/:submissionId

---

## 24/7 Carbon-Free Energy

### Hourly CFE Matching
GET /api/v1/cfe/matching/:facilityId
Query: ?start, end
Returns: hourly granular carbon-free energy certificates

### CFE Score
GET /api/v1/cfe/score/:facilityId

---

## Dispatch Engine

### Send Command
POST /api/v1/dispatch/:assetId/command
Body: { commandType: "charge"|"discharge"|"curtail"|"shed_load"|"restore"|"reduce", parameters: { targetKw, durationMin } }
Lifecycle: pending → dispatched → acknowledged → executed → completed/failed/cancelled
Protocol: auto-selects Modbus/IEC 61850/DNP3/BACnet/OCPP based on asset type
Note: Dispatch latency depends on protocol and network; command lifecycle is fully audited with state transitions and read-back verification

### Get Dispatch History
GET /api/v1/dispatch/:assetId/history

### Update Command Status
PATCH /api/v1/dispatch/commands/:commandId/status

### Execute Command
POST /api/v1/dispatch/commands/:commandId/execute
Includes: 2-second async read-back verification with 2% tolerance

---

## Demand Response

### Create DR Event
POST /api/v1/dr/events
Body: { facilityId, signalType: "shed"|"shift"|"shimmy", targetReductionKw, durationMinutes, subsystems }

### List DR Events
GET /api/v1/dr/events
Query: ?facilityId, status, startDate, endDate

### Active Events
GET /api/v1/dr/events/active

### Get Event Details
GET /api/v1/dr/events/:eventId

### Dispatch DR Event
POST /api/v1/dr/events/:eventId/dispatch

### Cancel DR
POST /api/v1/dr/events/:eventId/cancel

### Allocation Plan
GET /api/v1/dr/events/:eventId/allocation

### DR Summary
GET /api/v1/dr/summary/:facilityId

### Measure Response
POST /api/v1/dr/events/:eventId/measure

### M&V Report
GET /api/v1/dr/events/:eventId/mv-report

### Settle DR Event
POST /api/v1/dr/events/:eventId/settle
Includes: carbon attestation, baseline comparison, revenue calculation

### DR Revenue
POST /api/v1/dr/events/:eventId/revenue

### OpenADR Signal
POST /api/v1/dr/signals/openADR

### Manual Signal
POST /api/v1/dr/signals/manual

### Auto-Dispatch
POST /api/v1/dr/auto-dispatch
Body: { enabled: boolean }

---

## Settlements

### Generate Settlement
GET /api/v1/settlements/:siteId/generate
Query: ?start, end
Returns: hash-chained settlement with carbon attestation

### Carbon Attestation
GET /api/v1/settlements/:siteId/carbon-attestation

### Verify Settlement
GET /api/v1/settlements/:settlementId/verify

### Multi-Party Settlement
POST /api/v1/settlements/multiparty

### Invoice
POST /api/v1/settlements/:settlementId/invoice

### Confirm Settlement
POST /api/v1/settlements/:settlementId/confirm

### Export as W3C Credential
GET /api/v1/settlements/:settlementId/certificate

---

## Compliance

### Generate Compliance Package
POST /api/v1/comply/:siteId/generate
Standards: IEEE 2030.5, OpenADR 2.0b, IEC 61850, NERC CIP
Returns: SCL XML, checklist, evidence, gap analysis

### List Packages
GET /api/v1/comply/:siteId/packages

### Validate Compliance
GET /api/v1/comply/:siteId/validate

### Supported Standards
GET /api/v1/comply/standards

### Compliance Overview
GET /api/v1/comply/overview

### Scope 2 Report (GHG Protocol)
GET /api/v1/comply/scope2
Query: ?facility_id, start, end, methodology=location-based|market-based|dual
Formats: JSON, PDF, CSV

### Scope 2 Monthly
GET /api/v1/comply/scope2/monthly/:facilityId/:year

### Scope 2 Hourly
GET /api/v1/comply/scope2/hourly/:facilityId/:date

### Scope 2 Year-over-Year
GET /api/v1/comply/scope2/compare/:facilityId

### CSRD Disclosures
GET /api/v1/comply/csrd/e1 — ESRS E1 Climate Change
GET /api/v1/comply/csrd/e5 — ESRS E5 Resource Use
GET /api/v1/comply/csrd/full — Full CSRD environmental package
GET /api/v1/comply/csrd/gaps — Data gap analysis
POST /api/v1/comply/csrd/finalize — Save disclosure
GET /api/v1/comply/csrd/template/:standard — Blank ESRS template

### Regulatory Reports
POST /api/v1/comply/regulatory-reports — Save report
GET /api/v1/comply/regulatory-reports — List reports
GET /api/v1/comply/regulatory-reports/:id — Get report

### Audit Export
GET /api/v1/comply/audit/export
GET /api/v1/comply/audit/verify/:facilityId

### Subsidy Automation
GET /api/v1/comply/subsidies/scan/:facilityId — Scan 30+ programs
POST /api/v1/comply/subsidies/apply/:facilityId — Generate application

---

## Intelligence

### Asset Reliability Score
GET /api/v1/intel/assets/:id/score
Returns: delivery, response, availability, compliance scores → composite → tier (Platinum/Gold/Silver/Bronze)

### Site Reliability Score
GET /api/v1/intel/sites/:id/score

### Grid Capacity
GET /api/v1/intel/grid/:region/capacity
Regions: UAE, Saudi, PJM, ERCOT, CAISO, MISO, SPP, NYISO, DE

### Grid Trends
GET /api/v1/intel/grid/:region/trends

### Fleet Intelligence
GET /api/v1/intel/fleet/:fleetId

---

## Interconnection Planning

### Assess Interconnection
POST /api/v1/interconnection/assess
Body: { facilityId, region, requestedMw }
Returns: queue position, regulatory steps, upgrade cost estimation, timeline
Regions: UAE, Saudi, PJM, ERCOT, CAISO, India, DE

### Queue Position
GET /api/v1/interconnection/queue/:region

### Regulatory Requirements
GET /api/v1/interconnection/requirements/:region

### Cost Estimate
GET /api/v1/interconnection/cost-estimate

### Timeline
GET /api/v1/interconnection/timeline/:assessmentId

---

## Energy Cost Modeling

### Project Costs
POST /api/v1/cost-model/project
Body: { facilityId, tariffSchedule, years }
Tariffs: UAE_DEWA, UAE_ADDC, Saudi_SEC, US_PJM, US_ERCOT, US_CAISO, EU_DE
Returns: 10-year TCO with TOU multipliers, demand charges, PPA impact

### Compare Tariffs
POST /api/v1/cost-model/compare
Body: { facilityId, tariffs: string[] }

### PPA Impact
POST /api/v1/cost-model/ppa-impact

### TCO Summary
GET /api/v1/cost-model/tco/:facilityId

---

## Procurement

### Create Request
POST /api/v1/procurement
Body: { title, requiredCapacityMw, region, duration, type: "ppa"|"rec"|"carbon_offset" }

### Analyze Request
POST /api/v1/procurement/:id/analyze
Returns: ranked sites with fit score, AI recommendation

### Get Options
GET /api/v1/procurement/:id/options

### List Requests
GET /api/v1/procurement

---

## Battery Optimizer

### Optimize Schedule
POST /api/v1/battery/optimize
Body: { assetId, objective: "cost"|"carbon"|"reliability"|"balanced", horizon }
Returns: hourly charge/discharge schedule with degradation costing

### Revenue Stack
POST /api/v1/revenue-stack/optimize
Combines: DR + ancillary services + arbitrage

---

## Virtual Power Plant (VPP)

### Create VPP Dispatch
POST /api/v1/vpp/dispatch
Body: { fleetId, targetKw, duration }
Returns: coordinated multi-asset dispatch plan

### VPP Status
GET /api/v1/vpp/status/:fleetId

---

## Autonomous Grid Agent

### Start Agent
POST /api/v1/agent/start
Starts: RL-based OODA loop (Observe → Orient → Decide → Act)

### Stop Agent
POST /api/v1/agent/stop

### Agent Status
GET /api/v1/agent/status

### Decision History
GET /api/v1/agent/decisions
Returns: audit trail of all autonomous decisions with approval status

### Trigger Manual Cycle
POST /api/v1/agent/trigger

---

## Protocol Connections

### Connect to Device
POST /api/v1/connections/connect
Body: { protocol, host, port, deviceConfig }
Protocols: modbus, iec61850, dnp3, iec104, bacnet, snmp, ocpp, openadr, ieee2030_5, iccp

### Disconnect
POST /api/v1/connections/disconnect

### List Active Connections
GET /api/v1/connections

### Protocol-Specific Operations

#### Modbus
POST /api/v1/integrations/modbus/write — Write register/coil
GET /api/v1/integrations/modbus/read — Read holding registers

#### IEC 61850
GET /api/v1/integrations/iec61850 — All IED data
GET /api/v1/integrations/iec61850/:device — Single IED
GET /api/v1/integrations/iec61850/read/:objectRef — Read data object
POST /api/v1/integrations/iec61850/write — Write to IED
GET /api/v1/integrations/iec61850/compare — Multi-vendor comparison

#### DNP3
GET /api/v1/integrations/dnp3 — DNP3 outstation data
POST /api/v1/integrations/dnp3/connect — Connect to outstation
POST /api/v1/integrations/dnp3/write — Write to outstation

#### BACnet
GET /api/v1/integrations/bacnet/devices — Discover devices
GET /api/v1/integrations/bacnet/read/:deviceId/:objectType/:objectInstance — Read property
POST /api/v1/integrations/bacnet/write — Write property
GET /api/v1/integrations/bacnet/cooling/:deviceId — Read cooling setpoint
POST /api/v1/integrations/bacnet/cooling/:deviceId — Write cooling setpoint

#### SCADA Historian
GET /api/v1/integrations/historian — Current data + status
GET /api/v1/integrations/historian/tags — Tag list and values
POST /api/v1/integrations/historian/backfill — Historical data import
Backends: PI Web API, OPC-UA, CSV, Demo

#### Grid LMP Pricing
GET /api/v1/integrations/grid-prices — All ISO pricing
GET /api/v1/integrations/grid-prices/:region — Regional LMP
ISOs: PJM, ERCOT, CAISO, MISO, SPP, NYISO

#### Protocol Security
GET /api/v1/integrations/security — OT security posture
GET /api/v1/integrations/security/audit — Audit log

---

## OpenADR 2.0b

### VTN (Server)
EnergyAtIt runs a full OpenADR 2.0b VTN with XML↔JSON translation.
XML endpoints at /openadr/* (EiRegisterParty, EiEvent, EiReport)

### VEN (Client)
GET /api/v1/openadr/ven/status — VEN status
GET /api/v1/openadr/ven/events — Events received
GET /api/v1/openadr/ven/exchanges — Protocol exchange log

---

## ERCOT Market

GET /api/v1/ercot/dam-prices — Day-Ahead Market prices
GET /api/v1/ercot/fuel-mix — System-wide generation by fuel type
GET /api/v1/ercot/market-summary — LMP + fuel mix summary
POST /api/v1/ercot/bid-prep — Prepare energy + ancillary services bid

---

## Facilities

### CRUD
POST /api/v1/facilities — Create facility
GET /api/v1/facilities — List (tenant-scoped)
GET /api/v1/facilities/:id — Get details
PATCH /api/v1/facilities/:id — Update
DELETE /api/v1/facilities/:id — Deactivate

### Wizard
POST /api/v1/facilities/wizard — Composite creation (org + facility + carbon zone + first attestation)

### Devices & Topology
GET /api/v1/facilities/:id/devices — Topology + connections
PATCH /api/v1/facilities/:id/devices/:deviceId — Save connection
POST /api/v1/facilities/:id/devices/:deviceId/test — Test connection

### Dispatch & Proof
GET /api/v1/facilities/:id/dispatchable-assets
POST /api/v1/facilities/:id/first-dispatch — First dispatch lifecycle
GET /api/v1/facilities/:id/prove-it — Aggregated proof
POST /api/v1/facilities/:id/prove-it/comply — Compliance check
GET /api/v1/facilities/:id/go-live — Phase 5 graduation

---

## Fleets

GET /api/v1/fleets — List fleets
POST /api/v1/fleets — Create fleet
GET /api/v1/fleets/:fleetId — Get fleet
PUT /api/v1/fleets/:fleetId — Update fleet
POST /api/v1/fleets/:fleetId/members — Add facility to fleet

---

## Forecasting

GET /api/v1/forecasts/load/:facilityId — Load forecast
GET /api/v1/forecasts/price/:region — Price forecast
GET /api/v1/forecasts/emissions/:region — Emissions forecast
GET /api/v1/forecasts/meter/:meterId — Meter-level forecast
GET /api/v1/forecasts/fleet/:fleetId — Fleet forecast

---

## Scenario Engine

POST /api/v1/scenarios/run — Run what-if cost scenario
POST /api/v1/scenarios/compare — Compare multiple scenarios
POST /api/v1/scenarios/sensitivity — Parameter sweep for TCO impact
GET /api/v1/scenarios/presets — GCC/TAQA preset scenarios
POST /api/v1/scenarios/integrated-forecast — Combined price + emissions + cost

---

## Grid Code Compliance

POST /api/v1/scenarios/grid-code/assess — UAE/Saudi grid code assessment
GET /api/v1/scenarios/grid-code/requirements/:region — Requirements list
GET /api/v1/scenarios/grid-code/lvrt/:region — Low Voltage Ride-Through curve
POST /api/v1/scenarios/tariff-impact — Tariff change impact analysis
POST /api/v1/scenarios/tariff-compare — Compare tariff reform proposals

---

## DER Discovery

POST /api/v1/der/discover — Quick DER discovery from DB
POST /api/v1/der/scan — Full network scan (SunSpec Modbus probes)
GET /api/v1/der/inventory — DER type summary + total capacity

---

## DER Marketplace

POST /api/v1/der-market/register — Enroll DER for marketplace
GET /api/v1/der-market/programs — Available programs
POST /api/v1/der-market/enroll — Enroll in program
GET /api/v1/der-market/earnings — Aggregate DER earnings
GET /api/v1/der-market/stats — Platform-wide stats

---

## FERC Order 2222

POST /api/v1/ferc2222/aggregate — Aggregation for FERC 2222 compliance
GET /api/v1/ferc2222/status — Aggregation status

---

## EU EED Article 12

GET /api/v1/eu-eed/report — EU EED Article 12 reporting

---

## PUE & Cooling

GET /api/v1/pue/:facilityId — Current PUE breakdown
GET /api/v1/pue/:facilityId/history — PUE time-series
GET /api/v1/pue/recommend/:facilityId — Cooling optimization recommendations
GET /api/v1/pue/fleet — Fleet PUE leaderboard

---

## Cooling Demand Response

POST /api/v1/cooling-dr/plan — Cooling-specific DR curtailment plan
POST /api/v1/cooling-dr/pre-cool — Execute pre-cool strategy
POST /api/v1/cooling-dr/switch-mode — Switch cooling mode (chilled water ↔ free cooling)

---

## Workload Migration

POST /api/v1/workload-migration/recommend — Cross-facility recommendations
POST /api/v1/workload-migration/simulate — Simulate workload move

---

## Data Center Architecture

### Block Templates
GET /api/v1/templates — List block templates
GET /api/v1/templates/:id — Get template details
POST /api/v1/templates — Create template
POST /api/v1/templates/:id/clone — Clone template

### Campuses
GET /api/v1/campuses — List campuses
GET /api/v1/campuses/:id — Get campus + blocks
POST /api/v1/campuses — Create campus
POST /api/v1/campuses/:id/deploy — Deploy block to campus
GET /api/v1/campuses/:id/metrics — Aggregated metrics

---

## Power Analysis (Electrical Engineering)

POST /api/v1/power-analysis/load-flow — Backward/forward sweep load flow
POST /api/v1/power-analysis/short-circuit — IEC 60909 symmetrical analysis
POST /api/v1/power-analysis/arc-flash — IEEE 1584-2018 arc flash
POST /api/v1/power-analysis/full-study — Complete power system study

---

## Multimodal Intelligence

GET /api/v1/multimodal/briefing — Grid briefing fusing price + carbon + weather + renewables
GET /api/v1/multimodal/renewables — Solar/wind generation forecast
POST /api/v1/multimodal/compound-events — Cross-signal anomaly detection
GET /api/v1/multimodal/insights — Prioritized dispatch recommendations

---

## Edge Swarm Coordination

POST /api/v1/swarm/register — Register edge agent
GET /api/v1/swarm/agents — List edge agents
GET /api/v1/swarm/stats — Fleet statistics
POST /api/v1/swarm/command — Issue swarm command

---

## P2P Energy Trading

POST /api/v1/p2p/offer — Create sell offer
POST /api/v1/p2p/match — Match buy orders
GET /api/v1/p2p/history — Trade history

---

## Marketplace

GET /api/v1/marketplace — Search connectors + intelligence packs
POST /api/v1/marketplace/install — Install item
GET /api/v1/marketplace/:id — Item details
GET /api/v1/marketplace/:id/reviews — Item reviews
POST /api/v1/marketplace/:id/review — Submit review
GET /api/v1/marketplace/publisher/stats — Publisher stats

---

## Partners

POST /api/v1/partners/apply — Apply for partner program
GET /api/v1/partners/status — Application status
GET /api/v1/partners/tiers — Tier info (Silver/Gold/Platinum)
GET /api/v1/partners/stats — Partner stats
GET /api/v1/partners/evaluate — Auto-evaluation from metrics

---

## Tenants

POST /api/v1/tenants — Create tenant
GET /api/v1/tenants — List tenants
GET /api/v1/tenants/:id — Get tenant
PATCH /api/v1/tenants/:id — Update tenant
POST /api/v1/tenants/:id/members — Add member
DELETE /api/v1/tenants/:id/members/:userId — Remove member
GET /api/v1/tenants/:id/members — List members

---

## API Keys

POST /api/v1/api-keys — Generate key (eat_live_ or eat_test_ prefix)
GET /api/v1/api-keys — List keys (prefix only shown)
DELETE /api/v1/api-keys/:id — Revoke key

---

## Billing

POST /api/v1/billing/subscribe — Create subscription
Body: { plan: "developer"|"professional"|"enterprise" }
GET /api/v1/billing/usage — Usage metrics
GET /api/v1/billing/invoices — Invoices
GET /api/v1/billing/plan — Current plan
POST /api/v1/billing/cancel — Cancel subscription

---

## Onboarding Wizard

POST /api/v1/onboard/organization — Step 1: Create organization
POST /api/v1/onboard/facility — Step 2: Configure facility
POST /api/v1/onboard/carbon-zone — Step 3: Auto-detect grid zone
POST /api/v1/onboard/first-attestation — Step 4: First carbon attestation
GET /api/v1/onboard/status — Wizard progress

---

## Developer Journey

POST /api/v1/journey/register — Developer registration (public)
GET /api/v1/journey/progress — Progress + stage (token auth)
GET /api/v1/journey/leaderboard — Top 10
GET /api/v1/journey/challenges — Challenge list
POST /api/v1/journey/quiz/:stage/submit — Submit quiz
POST /api/v1/journey/sandbox/:primitive — Simulated API call
POST /api/v1/journey/feedback — Submit feedback
POST /api/v1/journey/submit — Prize entry
GET /api/v1/journey/certificate/:stage — PDF certificate

---

## Public Endpoints (No Auth)

GET /api/v1/health — Platform health + version
GET /api/v1/status — Service status
GET /api/v1/pricing — Pricing tiers
GET /api/public/stats — Platform statistics
GET /api/public/integrations — Integration status
POST /api/public/request-access — Request access form

---

## MCP Tools (151 total)

AI agents can use these tools via the Model Context Protocol:

### Site & Asset Management (6)
- list_sites — List all energy sites in your tenant
- get_site — Get details of a specific site
- list_assets — List assets, optionally filtered by site
- list_grid_connections — List grid connections for a site
- get_meter_readings — Get meter readings for a grid connection
- get_reliability_score — Get reliability scores for a site

### Dispatch & Control (3)
- dispatch_command — Send a dispatch command to an asset (battery, HVAC, EV charger)
- list_settlements — List settlements for a site
- get_grid_capacity — Get latest grid capacity snapshots for a region

### Settlement & Attestation (3)
- get_settlement — Generate a hash-chained settlement for a site
- get_carbon_attestation — Generate carbon attestation for a site
- get_live_grid_status — Get live integration status

### Compliance (3)
- generate_compliance_package — Generate packages (IEEE 2030.5, OpenADR, IEC 61850, NERC CIP)
- validate_compliance — Validate site compliance readiness
- list_compliance_packages — List all packages for a site

### Intelligence & Reliability (4)
- get_asset_reliability — Asset reliability score breakdown
- get_site_reliability — Site reliability with per-asset breakdown
- get_grid_capacity_intel — Grid capacity with utilization and queue depth
- create_procurement — Create procurement request

### Procurement (3)
- analyze_procurement — Analyze and rank available sites
- get_procurement_options — Get AI recommendation for procurement
- create_carbon_record — Create hash-chained carbon attestation record

### Carbon Attestation (5)
- verify_carbon_chain — Verify hash chain integrity for meter
- attest_energy — Record energy with auto carbon intensity lookup
- verify_chain — Verify hash chain with integrity scoring
- get_carbon_certificate — Generate GHG Protocol Scope 2 certificate
- query_carbon_history — Query aggregated carbon history (hourly/daily/monthly)

### GHG Reporting (1)
- comply_report — Generate GHG Protocol Scope 2 compliance report

### Demand Response (5)
- dispatch_dr_event — Create and dispatch DR event
- get_dr_status — Get active DR events status
- simulate_reduction — Simulate load reduction scenario
- verify_dr_response — Run M&V on completed DR event with carbon settlement
- (plus OpenADR signal handling)

### Fleet Intelligence (4)
- optimize_fleet — Recommend optimal workload distribution
- predict_load — Load forecast for facility or fleet
- recommend_dispatch — Dispatch recommendations from forecasts + carbon intensity
- (plus fleet carbon analysis)

### Protocol Connectivity (3)
- connect — Establish protocol connection (10 protocols supported)
- disconnect — Disconnect active connection
- list_connections — List all active connections with status

### Market Intelligence (3)
- forecast_prices — Energy price forecast with arbitrage windows
- forecast_emissions — Carbon intensity forecast with generation mix
- get_grid_health — Real-time grid health status

### Anomaly & Optimization (3)
- detect_anomalies — Multi-method anomaly detection (Z-score, rate-of-change, flatline, range, pattern)
- optimize_battery — BESS charge/discharge schedule with TOU optimization
- vpp_dispatch — Virtual Power Plant dispatch across fleet

### Energy Economics (2)
- calculate_revenue_share — Energy savings and revenue share
- list_carbon_credits — Available carbon marketplace listings

### Carbon Marketplace (3)
- search_carbon_credits — Search with filtering
- purchase_carbon_credits — Purchase from marketplace (double-spend prevention)
- generate_scope3_report — Scope 3 GHG report (9 categories)

### Interconnection & Planning (3)
- assess_interconnection — Grid interconnection feasibility + timeline + cost
- project_energy_costs — Multi-year cost projection with TOU and demand charges
- compare_tariffs — Compare costs across regions/tariffs

### Marketplace (2)
- search_marketplace — Search connectors and intelligence packs
- install_marketplace_item — Install marketplace item

### Agent Orchestration (4)
- observe_grid — Observe current grid state
- propose_dispatch — Propose dispatch action (load shifting, curtailment)
- execute_dispatch — Execute approved dispatch proposal
- simulate_whatif — Run what-if simulation on digital twin

### Jurisdiction Compliance (2)
- assess_compliance — Assess against jurisdiction requirements
- generate_report — Generate regulatory reports (Scope 2, CSRD E1/E5/Full)

### Subsidy Programs (5)
- list_subsidy_programs — List government incentive programs
- scan_subsidies — Scan active programs for facility eligibility
- check_subsidy_eligibility — Check specific program eligibility
- estimate_subsidy_value — Estimate financial value of program
- generate_subsidy_package — Generate application package

### Hyperscaler Carbon (3)
- get_tenant_carbon — Per-hyperscaler-tenant carbon summary
- list_hyperscaler_tenants — List hyperscaler sub-tenants
- get_tenant_scope2 — Scope 2 breakdown for hyperscaler tenant

### PUE & Cooling (4)
- get_facility_pue — Current PUE breakdown
- get_pue_history — PUE time-series history
- recommend_cooling — Cooling optimization recommendations
- get_fleet_pue — Fleet PUE leaderboard

### BACnet Protocol (5)
- list_bacnet_devices — Discover BACnet/IP devices
- read_bacnet_property — Read BACnet property
- write_bacnet_property — Write BACnet property
- set_cooling_setpoint — Set cooling setpoint on HVAC controller
- (plus BACnet device discovery)

### Cooling Demand Response (3)
- plan_cooling_curtailment — Cooling-specific DR curtailment plan
- execute_pre_cool — Pre-cool strategy before DR event
- switch_cooling_mode — Switch cooling mode (chilled water ↔ free cooling)

### Workload Migration (2)
- recommend_workload_migration — Cross-facility migration recommendations
- simulate_workload_migration — Simulate workload move between facilities

### Edge Points of Presence (6)
- list_pops — List edge PoPs by region
- get_pop_status — PoP details and metrics
- get_pop_carbon — Per-PoP carbon records with hash chain
- get_regional_carbon — Aggregated regional carbon
- get_scope3_cat8 — Scope 3 Category 8 summary
- get_vppa_matching — VPPA matching analysis

### Carbon Migration (2)
- recommend_pop_migration — Carbon-aware workload migration recommendations
- simulate_pop_migration — Simulate rack migration between PoPs

### DER Discovery (5)
- discover_der — Quick DER discovery from DB
- scan_der_network — Full network scan with SunSpec Modbus probes
- get_der_inventory — DER type summary + total capacity
- forecast_meter — Meter-level load forecast
- list_forecastable_meters — Meters with enough history for forecasting

### Scenario Analysis (5)
- run_scenario — What-if cost scenario
- compare_scenarios — Compare multiple scenarios side-by-side
- sensitivity_analysis — Parameter sweep for 10-year TCO impact
- integrated_forecast — Combined price + emissions + cost forecast
- gcc_scenario_presets — GCC/TAQA scenario presets

### Grid Code Compliance (5)
- assess_grid_code — UAE/Saudi grid code compliance assessment
- get_grid_code_requirements — Region-specific requirements
- get_lvrt_curve — Low Voltage Ride-Through curve
- analyze_tariff_impact — Tariff change impact on fleet
- compare_tariff_reforms — Compare tariff reform proposals

### Tariff & Regulations (2)
- gcc_reform_presets — GCC tariff reform scenario presets
- list_substations — GCC substations with capacity headroom

### ERCOT Market (4)
- get_ercot_dam_prices — Day-Ahead Market prices
- get_ercot_fuel_mix — Generation by fuel type
- get_ercot_market_summary — Market summary
- prepare_ercot_bid — Energy + ancillary services bid package

### Autonomous Grid Agent (5)
- start_grid_agent — Start autonomous OODA optimization loop
- stop_grid_agent — Stop agent loop
- get_agent_status — Current agent status
- get_agent_decisions — Decision history with audit trail
- trigger_agent_cycle — Manual OODA cycle

### DER Marketplace (5)
- register_der_marketplace — DER discovery for marketplace enrollment
- list_marketplace_programs — Available DER programs
- enroll_der_program — Enroll DER in program
- get_der_earnings — Aggregate DER earnings
- get_marketplace_stats — Platform-wide DER statistics

### Edge Swarm (4)
- register_edge_agent — Register edge agent
- list_edge_agents — List swarm fleet
- get_fleet_stats — Aggregate fleet statistics
- issue_swarm_command — Broadcast or targeted command

### P2P Trading (3)
- create_p2p_offer — Create P2P energy sell offer
- match_p2p_trades — Match P2P offers as buyer
- get_p2p_history — Trade history

### Multimodal Intelligence (4)
- get_grid_briefing — Fused price + carbon + weather + renewables briefing
- forecast_renewables — Solar/wind forecast from weather + capacity
- detect_compound_events — Cross-signal anomaly detection
- get_actionable_insights — Prioritized dispatch recommendations

### Data Center Architecture (7)
- list_block_templates — List block templates
- get_block_template — Get template configuration
- create_block_template — Create template (power, cooling, IT)
- clone_block_template — Clone template into draft
- list_campuses — List campuses with block counts
- get_campus — Campus details + deployed blocks
- create_campus — Create data center campus

### Block Deployment (2)
- deploy_block — Deploy block template to campus
- get_campus_metrics — Aggregated campus metrics

### Block Autonomy (3)
- get_block_autonomy_status — DC OS block autonomy status
- trigger_block_dr_shed — Block-level DR shed on campus
- get_bridge_activity_log — Cross-domain bridge actions

### Electrical Analysis (5)
- run_load_flow — Backward/forward sweep load flow
- run_short_circuit — IEC 60909 symmetrical short-circuit
- run_arc_flash — IEEE 1584-2018 arc flash analysis
- run_full_power_study — Complete power study
- get_facility_flexibility — Real-time DR flexibility snapshot

### Carbon & Facility Profiling (3)
- get_facility_carbon_profile — Facility carbon intensity profile
- dispatch_facility_flexibility — Utility-facing dispatch instruction
- get_attestation_pipeline_status — Autonomous action attestation pipeline status

---

## SDKs

### Python
```python
from energyatit import Client
client = Client(token="eat_live_...")
records = client.carbon_records("FAC-001")
attestation = client.attest_energy(meter_id="M-01", kwh=50.0)
chain = client.verify_chain("M-01")
```

### Node.js
```javascript
import { EnergyAtIt } from "@energyatit/sdk";
const client = new EnergyAtIt("eat_live_...");
const events = await client.drEvents();
const score = await client.assetReliability("ASSET-001");
```

### Go
```go
import "github.com/energyatit/sdk-go"
client := energyatit.NewWithToken("eat_live_...")
health, _ := client.Health()
```

---

## RBAC Roles

- **admin** — Full access to all operations
- **operator** — Dispatch, DR, settlements, carbon write + read all
- **viewer** — Read-only access
- **developer** — API keys, webhooks + read access
- **agent** — Read-only (for AI agents)

---

## Pricing Tiers

- **Developer** — Free. API access, sandbox, community support
- **Professional** — $499/month. Production deployment, SLA, priority support
- **Enterprise** — Custom. Dedicated infrastructure, custom SLA, onboarding

---

Contact: dsk@energyatit.com | Dubai, UAE
Website: https://energyatit.com
Last updated: 2026-03-01