naftiko: 1.0.0-alpha2
info:
  label: Robocorp Automation Orchestration
  description: Unified workflow capability for RPA automation orchestration using the Robocorp Control Room API. Combines
    worker management, process execution, work item queuing, secret management, asset storage, webhook configuration, and
    task package deployment into workflows for automation operations teams.
  tags:
  - RPA
  - Automation
  - Orchestration
  - Workflow
  - Robocorp
  - Python
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    ROBOCORP_API_KEY: ROBOCORP_API_KEY
    ROBOCORP_WORKSPACE_ID: ROBOCORP_WORKSPACE_ID
capability:
  consumes:
  - type: http
    namespace: control-room
    baseUri: https://cloud.robocorp.com/api/v1
    description: Robocorp Control Room API
    authentication:
      type: apikey
      key: Authorization
      value: RC-WSKEY {{ROBOCORP_API_KEY}}
      placement: header
    resources:
    - name: workspace
      path: /workspaces/{workspace_id}
      description: Workspace information
      operations:
      - name: get-workspace
        method: GET
        description: Get workspace details
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers
      path: /workspaces/{workspace_id}/workers
      description: Worker agent management
      operations:
      - name: list-workers
        method: GET
        description: List all workers in the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of workers
        - name: cursor
          in: query
          type: string
          required: false
          description: Pagination cursor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: worker-detail
      path: /workspaces/{workspace_id}/workers/{worker_id}
      description: Individual worker management
      operations:
      - name: get-worker
        method: GET
        description: Get a specific worker by ID
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: worker_id
          in: path
          type: string
          required: true
          description: Worker identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-worker
        method: DELETE
        description: Remove a worker from the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: worker_id
          in: path
          type: string
          required: true
          description: Worker identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: worker-groups
      path: /workspaces/{workspace_id}/worker-groups
      description: Worker group management
      operations:
      - name: list-worker-groups
        method: GET
        description: List all worker groups
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-worker-group
        method: POST
        description: Create a new worker group
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            description: '{{tools.description}}'
    - name: processes
      path: /workspaces/{workspace_id}/processes
      description: Process management
      operations:
      - name: list-processes
        method: GET
        description: List all processes in the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-process
        method: POST
        description: Create a new process
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            description: '{{tools.description}}'
    - name: process-runs
      path: /workspaces/{workspace_id}/processes/{process_id}/runs
      description: Process run management
      operations:
      - name: list-process-runs
        method: GET
        description: List all runs for a process
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: process_id
          in: path
          type: string
          required: true
          description: Process identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: start-process-run
        method: POST
        description: Start a new process run
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: process_id
          in: path
          type: string
          required: true
          description: Process identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            variables: '{{tools.variables}}'
    - name: work-items
      path: /workspaces/{workspace_id}/work-items
      description: Work item queue management
      operations:
      - name: list-work-items
        method: GET
        description: List work items in the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        - name: process_id
          in: query
          type: string
          required: false
          description: Filter by process
        - name: state
          in: query
          type: string
          required: false
          description: Filter by work item state
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-work-item
        method: POST
        description: Create a new work item in the queue
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            process_id: '{{tools.process_id}}'
            payload: '{{tools.payload}}'
    - name: vault-secrets
      path: /workspaces/{workspace_id}/vault/secrets
      description: Vault secret management
      operations:
      - name: list-secrets
        method: GET
        description: List secret names in the vault (values not returned)
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-secret
        method: POST
        description: Create a new vault secret
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            value: '{{tools.value}}'
    - name: webhooks
      path: /workspaces/{workspace_id}/webhooks
      description: Webhook configuration
      operations:
      - name: list-webhooks
        method: GET
        description: List all configured webhooks
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-webhook
        method: POST
        description: Create a process webhook for event notifications
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            process_id: '{{tools.process_id}}'
            url: '{{tools.url}}'
            events: '{{tools.events}}'
    - name: assets
      path: /workspaces/{workspace_id}/assets
      description: Asset storage management
      operations:
      - name: list-assets
        method: GET
        description: List all assets in the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-asset
        method: POST
        description: Create a new asset in storage
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            content_type: '{{tools.content_type}}'
    - name: task-packages
      path: /workspaces/{workspace_id}/task-packages
      description: Task package deployment
      operations:
      - name: list-task-packages
        method: GET
        description: List all task packages in the workspace
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-task-package
        method: POST
        description: Deploy a new task package from zip, GitHub, or GitLab
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
          description: Workspace identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            source_type: '{{tools.source_type}}'
            source_url: '{{tools.source_url}}'
  exposes:
  - type: rest
    port: 8080
    namespace: robocorp-orchestration-api
    description: Unified REST API for Robocorp RPA automation orchestration.
    resources:
    - path: /v1/workspace
      name: workspace
      description: Workspace management
      operations:
      - method: GET
        name: get-workspace
        description: Get workspace details
        call: control-room.get-workspace
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers
      name: workers
      description: Worker agent management
      operations:
      - method: GET
        name: list-workers
        description: List all workers in the workspace
        call: control-room.list-workers
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{worker-id}
      name: worker-detail
      description: Individual worker
      operations:
      - method: GET
        name: get-worker
        description: Get a specific worker
        call: control-room.get-worker
        with:
          workspace_id: rest.workspace_id
          worker_id: rest.worker-id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-worker
        description: Remove a worker
        call: control-room.delete-worker
        with:
          workspace_id: rest.workspace_id
          worker_id: rest.worker-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/worker-groups
      name: worker-groups
      description: Worker group organization
      operations:
      - method: GET
        name: list-worker-groups
        description: List all worker groups
        call: control-room.list-worker-groups
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-worker-group
        description: Create a new worker group
        call: control-room.create-worker-group
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/processes
      name: processes
      description: Automation process management
      operations:
      - method: GET
        name: list-processes
        description: List all automation processes
        call: control-room.list-processes
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-process
        description: Create a new automation process
        call: control-room.create-process
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/processes/{process-id}/runs
      name: process-runs
      description: Process execution runs
      operations:
      - method: GET
        name: list-process-runs
        description: List all runs for a process
        call: control-room.list-process-runs
        with:
          workspace_id: rest.workspace_id
          process_id: rest.process-id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: start-process-run
        description: Start a new process run
        call: control-room.start-process-run
        with:
          workspace_id: rest.workspace_id
          process_id: rest.process-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/work-items
      name: work-items
      description: Work item queue management
      operations:
      - method: GET
        name: list-work-items
        description: List work items in the queue
        call: control-room.list-work-items
        with:
          workspace_id: rest.workspace_id
          process_id: rest.process_id
          state: rest.state
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-work-item
        description: Add a new work item to the queue
        call: control-room.create-work-item
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/assets
      name: assets
      description: Asset storage
      operations:
      - method: GET
        name: list-assets
        description: List all assets
        call: control-room.list-assets
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-asset
        description: Create a new asset
        call: control-room.create-asset
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/secrets
      name: vault-secrets
      description: Vault secret management
      operations:
      - method: GET
        name: list-secrets
        description: List secret names in the vault
        call: control-room.list-secrets
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-secret
        description: Create a new vault secret
        call: control-room.create-secret
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/webhooks
      name: webhooks
      description: Webhook configuration
      operations:
      - method: GET
        name: list-webhooks
        description: List all webhooks
        call: control-room.list-webhooks
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-webhook
        description: Create a process webhook
        call: control-room.create-webhook
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/task-packages
      name: task-packages
      description: Task package deployment
      operations:
      - method: GET
        name: list-task-packages
        description: List all task packages
        call: control-room.list-task-packages
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-task-package
        description: Deploy a new task package
        call: control-room.create-task-package
        with:
          workspace_id: rest.workspace_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: robocorp-orchestration-mcp
    transport: http
    description: MCP server for AI-assisted Robocorp RPA automation orchestration.
    tools:
    - name: get-workspace
      description: Get workspace configuration and details
      hints:
        readOnly: true
        openWorld: false
      call: control-room.get-workspace
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-workers
      description: List all automation workers and their status
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-workers
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-worker
      description: Get details and status for a specific worker
      hints:
        readOnly: true
        openWorld: false
      call: control-room.get-worker
      with:
        workspace_id: tools.workspace_id
        worker_id: tools.worker_id
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-worker
      description: Remove a worker from the workspace
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: control-room.delete-worker
      with:
        workspace_id: tools.workspace_id
        worker_id: tools.worker_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-worker-groups
      description: List all worker groups for organizing workers
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-worker-groups
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-worker-group
      description: Create a new worker group for organizing automation workers
      hints:
        readOnly: false
        destructive: false
      call: control-room.create-worker-group
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-processes
      description: List all automation processes defined in the workspace
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-processes
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-process
      description: Define a new automation process with steps and schedules
      hints:
        readOnly: false
        destructive: false
      call: control-room.create-process
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-process-runs
      description: List all execution runs for an automation process
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-process-runs
      with:
        workspace_id: tools.workspace_id
        process_id: tools.process_id
      outputParameters:
      - type: object
        mapping: $.
    - name: start-process-run
      description: Trigger a new execution run for an automation process
      hints:
        readOnly: false
        destructive: false
      call: control-room.start-process-run
      with:
        workspace_id: tools.workspace_id
        process_id: tools.process_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-work-items
      description: List work items in the queue with optional state filter
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-work-items
      with:
        workspace_id: tools.workspace_id
        process_id: tools.process_id
        state: tools.state
      outputParameters:
      - type: object
        mapping: $.
    - name: create-work-item
      description: Add a new work item to the process queue
      hints:
        readOnly: false
        destructive: false
      call: control-room.create-work-item
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-assets
      description: List all stored assets in the workspace
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-assets
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-secrets
      description: List vault secret names (secret values are never returned)
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-secrets
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-webhooks
      description: List all configured webhooks for process event notifications
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-webhooks
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-task-packages
      description: List all deployed task packages in the workspace
      hints:
        readOnly: true
        openWorld: false
      call: control-room.list-task-packages
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-task-package
      description: Deploy a new task package from zip, GitHub, or GitLab source
      hints:
        readOnly: false
        destructive: false
      call: control-room.create-task-package
      with:
        workspace_id: tools.workspace_id
      outputParameters:
      - type: object
        mapping: $.