Cumulocity · Capability

Cumulocity Edge — System

Inspect status, restart, manage cloud sync, and install software updates on a Cumulocity Edge node.

Cumulocity Edge — System is a Naftiko capability published by Cumulocity, one of 31 capabilities the APIs.io network indexes for this provider. It bundles 3 operations.

The capability includes 1 read-only operation and 2 state-changing operations. Lead operation: Retrieve the Cumulocity Edge node status (services, storage, version). Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Cumulocity, Edge, and On-Premises.

Run with Naftiko CumulocityEdgeOn-Premises

MCP Tools

cumulocity-edge-status

Retrieve the Cumulocity Edge node status (services, storage, version).

read-only idempotent
cumulocity-edge-update-cloud-sync

Update the Cumulocity Edge cloud-sync configuration.

idempotent
cumulocity-edge-install-update

Install a Cumulocity Edge software update.

Capability Spec

edge-system.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Cumulocity Edge — System
  description: Inspect status, restart, manage cloud sync, and install software updates on a Cumulocity Edge node.
  tags: [Cumulocity, Edge, On-Premises]
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    C8Y_EDGE_URL: C8Y_EDGE_URL
    C8Y_USER: C8Y_USER
    C8Y_PASSWORD: C8Y_PASSWORD
capability:
  consumes:
  - type: http
    namespace: edge-system
    baseUri: '{{env.C8Y_EDGE_URL}}'
    resources:
    - name: system
      path: /service/edge/system
      operations:
      - name: getedgesystemstatus
        method: GET
        description: Retrieve Edge System Status
    - name: restart
      path: /service/edge/system/restart
      operations:
      - name: restartedge
        method: POST
        description: Restart The Edge System
    - name: cloud-sync
      path: /service/edge/cloud-sync
      operations:
      - name: getcloudsync
        method: GET
        description: Retrieve Cloud Sync Configuration
      - name: updatecloudsync
        method: PUT
        description: Update Cloud Sync Configuration
        inputParameters:
        - {name: body, in: body, type: object, required: true}
    - name: updates
      path: /service/edge/updates
      operations:
      - name: listedgeupdates
        method: GET
        description: List Available Edge Updates
      - name: installedgeupdate
        method: POST
        description: Install An Edge Update
        inputParameters:
        - {name: body, in: body, type: object, required: true}
    authentication:
      type: basic
      username: '{{env.C8Y_USER}}'
      password: '{{env.C8Y_PASSWORD}}'
  exposes:
  - type: mcp
    namespace: edge-system-mcp
    port: 9090
    transport: http
    tools:
    - name: cumulocity-edge-status
      description: Retrieve the Cumulocity Edge node status (services, storage, version).
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: edge-system.getedgesystemstatus
      with: {}
    - name: cumulocity-edge-update-cloud-sync
      description: Update the Cumulocity Edge cloud-sync configuration.
      hints: {readOnly: false, destructive: false, idempotent: true}
      call: edge-system.updatecloudsync
      with: {body: tools.body}
    - name: cumulocity-edge-install-update
      description: Install a Cumulocity Edge software update.
      hints: {readOnly: false, destructive: false, idempotent: false}
      call: edge-system.installedgeupdate
      with: {body: tools.body}