TD SYNNEX Cloud Marketplace

naftiko: "1.0.0-alpha1"

info:
  label: "TD SYNNEX Cloud Marketplace"
  description: >-
    Unified cloud marketplace capability for TD SYNNEX resellers. Combines customer
    management, product catalog browsing, order creation, subscription lifecycle
    management, and reporting through the StreamOne ION API. Enables resellers to
    automate cloud subscription operations for Microsoft, Google, and other vendor products.
  tags:
    - TD SYNNEX
    - Cloud Marketplace
    - Subscription Management
    - IT Distribution
    - Order Management
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      SYNNEX_ION_ACCESS_TOKEN: SYNNEX_ION_ACCESS_TOKEN
      SYNNEX_ACCOUNT_ID: SYNNEX_ACCOUNT_ID

capability:
  consumes:
    - import: synnex-ion
      location: ./shared/streamone-ion.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: synnex-cloud-marketplace-api
      description: "Unified REST API for TD SYNNEX cloud marketplace operations."
      resources:
        - path: /v1/customers
          name: customers
          description: "End customer account management."
          operations:
            - method: GET
              name: list-customers
              description: "List all end customers for the reseller account."
              call: "synnex-ion.list-customers"
              with:
                accountId: "rest.accountId"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-customer
              description: "Create a new end customer account."
              call: "synnex-ion.create-customer"
              with:
                accountId: "rest.accountId"
                companyName: "rest.companyName"
                email: "rest.email"
                country: "rest.country"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/products
          name: products
          description: "Cloud product catalog."
          operations:
            - method: GET
              name: list-products
              description: "Browse available cloud products and SKUs."
              call: "synnex-ion.list-products"
              with:
                accountId: "rest.accountId"
                vendor: "rest.vendor"
                category: "rest.category"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/orders
          name: orders
          description: "Order management."
          operations:
            - method: GET
              name: list-orders
              description: "List orders for the reseller account."
              call: "synnex-ion.list-orders"
              with:
                accountId: "rest.accountId"
                status: "rest.status"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-order
              description: "Create a new cloud product order for a customer."
              call: "synnex-ion.create-order"
              with:
                accountId: "rest.accountId"
                customerId: "rest.customerId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/subscriptions
          name: subscriptions
          description: "Cloud subscription management."
          operations:
            - method: GET
              name: list-subscriptions
              description: "List cloud subscriptions for an end customer."
              call: "synnex-ion.list-subscriptions"
              with:
                accountId: "rest.accountId"
                customerId: "rest.customerId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/reports
          name: reports
          description: "Usage and billing reports."
          operations:
            - method: GET
              name: list-reports
              description: "List available usage and billing reports."
              call: "synnex-ion.list-reports"
              with:
                accountId: "rest.accountId"
                format: "rest.format"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: synnex-cloud-marketplace-mcp
      transport: http
      description: "MCP server for AI-assisted cloud marketplace operations via TD SYNNEX StreamOne ION."
      tools:
        - name: list-customers
          description: "List end customers managed by the reseller in the TD SYNNEX cloud marketplace."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "synnex-ion.list-customers"
          with:
            accountId: "tools.accountId"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-customer
          description: "Create a new end customer account in the TD SYNNEX cloud marketplace."
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "synnex-ion.create-customer"
          with:
            accountId: "tools.accountId"
            companyName: "tools.companyName"
            email: "tools.email"
            country: "tools.country"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-products
          description: "Browse the TD SYNNEX cloud product catalog with filtering by vendor and category."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "synnex-ion.list-products"
          with:
            accountId: "tools.accountId"
            vendor: "tools.vendor"
            category: "tools.category"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-orders
          description: "List cloud product orders for the reseller account."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "synnex-ion.list-orders"
          with:
            accountId: "tools.accountId"
            status: "tools.status"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-order
          description: "Create a new cloud product order for an end customer through TD SYNNEX."
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "synnex-ion.create-order"
          with:
            accountId: "tools.accountId"
            customerId: "tools.customerId"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-subscriptions
          description: "List active cloud subscriptions for an end customer."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "synnex-ion.list-subscriptions"
          with:
            accountId: "tools.accountId"
            customerId: "tools.customerId"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-reports
          description: "List available usage and billing reports for the reseller account."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "synnex-ion.list-reports"
          with:
            accountId: "tools.accountId"
            format: "tools.format"
          outputParameters:
            - type: object
              mapping: "$."