PortainerCE API — intel

naftiko: 1.0.0-alpha2
info:
  label: PortainerCE API — intel
  description: 'PortainerCE API — intel. 6 operations. Lead operation: Enable Portainer''s OpenAMT capabilities. Self-contained
    Naftiko capability covering one Portainer business surface.'
  tags:
  - Portainer
  - intel
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PORTAINER_API_KEY: PORTAINER_API_KEY
capability:
  consumes:
  - type: http
    namespace: portainer-intel
    baseUri: ''
    description: PortainerCE API — intel business capability. Self-contained, no shared references.
    resources:
    - name: open_amt
      path: /open_amt
      operations:
      - name: openamtconfigure
        method: POST
        description: Enable Portainer's OpenAMT capabilities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: string
          description: OpenAMT Settings
          required: true
    - name: open_amt-id-activate
      path: /open_amt/{id}/activate
      operations:
      - name: openamtactivate
        method: POST
        description: Activate OpenAMT device and associate to agent endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Environment identifier
          required: true
    - name: open_amt-id-devices
      path: /open_amt/{id}/devices
      operations:
      - name: openamtdevices
        method: GET
        description: Fetch OpenAMT managed devices information for endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Environment(Endpoint) identifier
          required: true
    - name: open_amt-id-devices-deviceId-action
      path: /open_amt/{id}/devices/{deviceId}/action
      operations:
      - name: deviceaction
        method: POST
        description: Execute out of band action on an AMT managed device
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Environment identifier
          required: true
        - name: deviceId
          in: path
          type: integer
          description: Device identifier
          required: true
        - name: body
          in: body
          type: string
          description: Device Action
          required: true
    - name: open_amt-id-devices_features-deviceId
      path: /open_amt/{id}/devices_features/{deviceId}
      operations:
      - name: devicefeatures
        method: POST
        description: Enable features on an AMT managed device
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Environment identifier
          required: true
        - name: deviceId
          in: path
          type: integer
          description: Device identifier
          required: true
        - name: body
          in: body
          type: string
          description: Device Features
          required: true
    - name: open_amt-id-info
      path: /open_amt/{id}/info
      operations:
      - name: openamthostinfo
        method: GET
        description: Request OpenAMT info from a node
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Environment identifier
          required: true
  exposes:
  - type: rest
    namespace: portainer-intel-rest
    port: 8080
    description: REST adapter for PortainerCE API — intel. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/open-amt
      name: open-amt
      description: REST surface for open_amt.
      operations:
      - method: POST
        name: openamtconfigure
        description: Enable Portainer's OpenAMT capabilities
        call: portainer-intel.openamtconfigure
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/open-amt/{id}/activate
      name: open-amt-id-activate
      description: REST surface for open_amt-id-activate.
      operations:
      - method: POST
        name: openamtactivate
        description: Activate OpenAMT device and associate to agent endpoint
        call: portainer-intel.openamtactivate
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/open-amt/{id}/devices
      name: open-amt-id-devices
      description: REST surface for open_amt-id-devices.
      operations:
      - method: GET
        name: openamtdevices
        description: Fetch OpenAMT managed devices information for endpoint
        call: portainer-intel.openamtdevices
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/open-amt/{id}/devices/{deviceid}/action
      name: open-amt-id-devices-deviceid-action
      description: REST surface for open_amt-id-devices-deviceId-action.
      operations:
      - method: POST
        name: deviceaction
        description: Execute out of band action on an AMT managed device
        call: portainer-intel.deviceaction
        with:
          id: rest.id
          deviceId: rest.deviceId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/open-amt/{id}/devices-features/{deviceid}
      name: open-amt-id-devices-features-deviceid
      description: REST surface for open_amt-id-devices_features-deviceId.
      operations:
      - method: POST
        name: devicefeatures
        description: Enable features on an AMT managed device
        call: portainer-intel.devicefeatures
        with:
          id: rest.id
          deviceId: rest.deviceId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/open-amt/{id}/info
      name: open-amt-id-info
      description: REST surface for open_amt-id-info.
      operations:
      - method: GET
        name: openamthostinfo
        description: Request OpenAMT info from a node
        call: portainer-intel.openamthostinfo
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: portainer-intel-mcp
    port: 9090
    transport: http
    description: MCP adapter for PortainerCE API — intel. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: enable-portainer-s-openamt-capabilities
      description: Enable Portainer's OpenAMT capabilities
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: portainer-intel.openamtconfigure
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: activate-openamt-device-and-associate
      description: Activate OpenAMT device and associate to agent endpoint
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: portainer-intel.openamtactivate
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: fetch-openamt-managed-devices-information
      description: Fetch OpenAMT managed devices information for endpoint
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: portainer-intel.openamtdevices
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-out-band-action-amt
      description: Execute out of band action on an AMT managed device
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: portainer-intel.deviceaction
      with:
        id: tools.id
        deviceId: tools.deviceId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-features-amt-managed-device
      description: Enable features on an AMT managed device
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: portainer-intel.devicefeatures
      with:
        id: tools.id
        deviceId: tools.deviceId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-openamt-info-node
      description: Request OpenAMT info from a node
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: portainer-intel.openamthostinfo
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.