naftiko: 1.0.0-alpha2
info:
  label: Gridshare Customer API — Plans
  description: 'Gridshare Customer API v2 — Overlay Plans for short-term device dispatch under lunar/plan.* scopes.'
  tags:
    - Lunar Energy
    - Gridshare
    - Customer
    - Plans
    - Overlay
  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-plans
      baseUri: https://developer-api.customer.mygridshare.com
      description: Gridshare Customer Overlay Plans.
      resources:
        - name: devices-synthid-plans-overlay
          path: /api/v2/devices/{synthId}/plans/overlay
          operations:
            - name: getoverlay
              method: GET
              description: Get Device Overlay Plan
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
            - name: setoverlay
              method: PUT
              description: Set Device Overlay Plan
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
      authentication:
        type: bearer
        value: '{{env.GRIDSHARE_CUSTOMER_ACCESS_TOKEN}}'
        placement: header
  exposes:
    - type: mcp
      namespace: customer-plans-mcp
      port: 9090
      transport: http
      description: MCP adapter for Gridshare Customer Plans.
      tools:
        - name: gridshare-customer-get-overlay-plan
          description: Get Device Overlay Plan
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: customer-plans.getoverlay
          outputParameters: [{ type: object, mapping: $. }]
        - name: gridshare-customer-set-overlay-plan
          description: Set Device Overlay Plan
          hints: { readOnly: false, destructive: true, idempotent: true }
          call: customer-plans.setoverlay
          outputParameters: [{ type: object, mapping: $. }]