Lunar Energy · Capability

Gridshare Customer API — Plans

Gridshare Customer API v2 — Overlay Plans for short-term device dispatch under lunar/plan.* scopes.

Gridshare Customer API — Plans is a Naftiko capability published by Lunar Energy, one of 9 capabilities the APIs.io network indexes for this provider. It bundles 2 operations.

The capability includes 1 read-only operation and 1 state-changing operation. Lead operation: Get Device Overlay Plan. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Lunar Energy, Gridshare, Customer, Plans, and Overlay.

Run with Naftiko Lunar EnergyGridshareCustomerPlansOverlay

MCP Tools

gridshare-customer-get-overlay-plan

Get Device Overlay Plan

read-only idempotent

gridshare-customer-set-overlay-plan

Set Device Overlay Plan

idempotent

Capability Spec

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: $. }]