Azure Quantum Workspace — Top-Level Items

naftiko: 1.0.0-alpha2
info:
  label: Azure Quantum Workspace — Top-Level Items
  description: Unified listing of jobs and sessions exposed through the top-level items endpoint.
  tags:
    - Azure Quantum
    - Items
    - Jobs
    - Sessions
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      AZURE_QUANTUM_BEARER: AZURE_QUANTUM_BEARER
      AZURE_SUBSCRIPTION_ID: AZURE_SUBSCRIPTION_ID
      AZURE_RESOURCE_GROUP: AZURE_RESOURCE_GROUP
      AZURE_QUANTUM_WORKSPACE: AZURE_QUANTUM_WORKSPACE
capability:
  consumes:
    - type: http
      namespace: items-items
      baseUri: https://management.azure.com
      resources:
        - name: top-level-items
          path: /subscriptions/{{env.AZURE_SUBSCRIPTION_ID}}/resourceGroups/{{env.AZURE_RESOURCE_GROUP}}/providers/Microsoft.Quantum/workspaces/{{env.AZURE_QUANTUM_WORKSPACE}}/topLevelItems
          operations:
            - name: listitems
              method: GET
              description: List Top-Level Items (Jobs Plus Sessions) In The Workspace.
      authentication:
        type: bearer
        value: '{{env.AZURE_QUANTUM_BEARER}}'
        placement: header
  exposes:
    - type: mcp
      namespace: items-items-mcp
      port: 9090
      transport: http
      tools:
        - name: azure-quantum-list-items
          description: List top-level jobs and sessions in the workspace.
          hints:
            readOnly: true
          call: items-items.listitems