naftiko: 1.0.0-alpha2
info:
  label: Gridshare Customer API — Sites
  description: 'Gridshare Customer API v2 — list of accessible sites and their topology trees for the authenticated homeowner.'
  tags:
    - Lunar Energy
    - Gridshare
    - Customer
    - Sites
    - Topology
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      GRIDSHARE_CUSTOMER_ACCESS_TOKEN: GRIDSHARE_CUSTOMER_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: customer-sites
      baseUri: https://developer-api.customer.mygridshare.com
      description: Gridshare Customer Sites resource family.
      resources:
        - name: sites
          path: /api/v2/sites
          operations:
            - name: listsites
              method: GET
              description: List Sites
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: sites-siteid-topology
          path: /api/v2/sites/{siteId}/topology
          operations:
            - name: gettopology
              method: GET
              description: Get Site Topology
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
      authentication:
        type: bearer
        value: '{{env.GRIDSHARE_CUSTOMER_ACCESS_TOKEN}}'
        placement: header
  exposes:
    - type: mcp
      namespace: customer-sites-mcp
      port: 9090
      transport: http
      description: MCP adapter for Gridshare Customer Sites.
      tools:
        - name: gridshare-customer-list-sites
          description: List Sites
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: customer-sites.listsites
          outputParameters: [{ type: object, mapping: $. }]
        - name: gridshare-customer-get-topology
          description: Get Site Topology
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: customer-sites.gettopology
          outputParameters: [{ type: object, mapping: $. }]