generated: '2026-07-27'
method: derived
status: candidate
source: openapi/alectra-utilities-green-button-espi-openapi.json
searched:
  official_server_found: false
  where_searched:
  - Alectra Utilities website and Green Button pages (no developer surface of any kind)
  - Both Savage Data Systems Alectra hosts (portal and onboarding) — catch-all responses only
  - Green Button Alliance GitHub organisation (57 public repositories; no MCP server)
  note: No official or third-party hosted MCP server exists for Alectra Utilities or for the Green Button
    ESPI surface. The tools below are a CANDIDATE mapping derived one-to-one from the operations of the
    Green Button Alliance ESPI contract in openapi/. They are not deployed, and they could not be deployed
    against Alectra without completing third-party registration and approval and being issued a base URI
    and OAuth client credentials.
server:
  name: alectra-utilities-green-button
  transport: null
  url: null
  deployed: false
auth_required:
  scheme: oauth2
  flows:
  - authorizationCode
  - clientCredentials
  gate: Third-party registration and Alectra approval at https://alectrautilitiesonboarding.savagedata.com/,
    then per-customer consent. An agent cannot self-serve onto this API.
tools:
- name: list_application_information
  description: List Application Information registration records for third-party applications.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#findApplicationInformations
  method: GET
  path: /espi/1_1/resource/ApplicationInformation
  read_only: true
- name: get_application_information
  description: Retrieve a single Application Information record by id.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#getApplicationInformation
  method: GET
  path: /espi/1_1/resource/ApplicationInformation/{applicationInformationId}
  read_only: true
- name: list_authorizations
  description: List customer Authorizations granted to the calling third party.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#findAuthorizations
  method: GET
  path: /espi/1_1/resource/Authorization
  read_only: true
- name: get_authorization
  description: Retrieve a single Authorization (consent record) by id, including its status, scope and
    resource URIs.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#getAuthorization
  method: GET
  path: /espi/1_1/resource/Authorization/{authorizationId}
  read_only: true
- name: list_usage_points
  description: List Usage Points (metered service points) the caller is authorised to read.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#findUsagePoints
  method: GET
  path: /espi/1_1/resource/UsagePoint
  read_only: true
- name: get_usage_point
  description: Retrieve a single Usage Point by id.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#getUsagePoint
  method: GET
  path: /espi/1_1/resource/UsagePoint/{usagePointId}
  read_only: true
- name: download_bulk_data
  description: Request a bulk transfer of ESPI resources by bulk id. May return HTTP 202 while the batch
    is prepared.
  source_operation: openapi/alectra-utilities-green-button-espi-openapi.json#downloadBulkData
  method: GET
  path: /espi/1_1/resource/Batch/Bulk/{bulkId}
  read_only: true
agent_notes:
- Every tool is a read; the contract exposes no write operations.
- Responses are application/atom+xml, not JSON — an agent must parse Atom + ESPI XML.
- Collections page with start-index (1-indexed) and max-results, and filter with published-min/published-max/updated-min/updated-max
  as RFC 3339 instants.
- The depth parameter controls how much of the related ESPI graph is inlined.
- A 403 usually means the customer Authorization is expired, revoked (status 0) or denied (status 2),
  not that the resource is missing.
- This data is personal consumption data for an identified retail customer. Use is bound by the customer's
  express consent and by Alectra's Green Button Connect My Data Terms and Conditions of Access and Use.
deployment:
  mode: none
  verified: derived
  tools: 7
  checked: '2026-08-12'
  source: catalog MCP census