SAP Commerce Cloud Catalog and Content Management

naftiko: "1.0.0-alpha1"

info:
  label: "SAP Commerce Cloud Catalog and Content Management"
  description: "Workflow capability for managing product catalogs, categories, and content in SAP Commerce Cloud. Combines catalog browsing, product content management, and customer service workflows. Used by catalog managers, merchandisers, and content administrators."
  tags:
    - Catalog
    - Commerce
    - Content Management
    - SAP
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      SAP_COMMERCE_OAUTH_TOKEN: SAP_COMMERCE_OAUTH_TOKEN

capability:
  consumes:
    - import: sap-commerce-occ
      location: ./shared/commerce-web-services.yaml
    - import: sap-commerce-pcm
      location: ./shared/product-content-management.yaml
    - import: sap-commerce-asm
      location: ./shared/assisted-service.yaml

  exposes:
    - type: rest
      port: 8081
      namespace: sap-commerce-catalog-api
      description: "Unified REST API for SAP Commerce Cloud catalog and content management."
      resources:
        - path: /v1/catalogs
          name: catalogs
          description: "Product catalog management."
          operations:
            - method: GET
              name: list-catalogs
              description: "List product catalogs."
              call: "sap-commerce-pcm.list-catalogs"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/catalogs/{catalogId}
          name: catalog
          description: "Single product catalog."
          operations:
            - method: GET
              name: get-catalog
              description: "Get catalog details."
              call: "sap-commerce-pcm.get-catalog"
              with:
                catalogId: "rest.catalogId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/products
          name: products
          description: "Product search."
          operations:
            - method: GET
              name: search-products
              description: "Search products in the catalog."
              call: "sap-commerce-occ.search-products"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/customers
          name: customers
          description: "Customer search for assisted service."
          operations:
            - method: GET
              name: search-customers
              description: "Search customers for assisted service."
              call: "sap-commerce-asm.search-customers"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9081
      namespace: sap-commerce-catalog-mcp
      transport: http
      description: "MCP server for AI-assisted SAP Commerce Cloud catalog and content management."
      tools:
        - name: list-catalogs
          description: "List available product catalogs in SAP Commerce Cloud."
          hints:
            readOnly: true
            openWorld: true
          call: "sap-commerce-pcm.list-catalogs"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-catalog
          description: "Get structure, versions, and configuration of a product catalog."
          hints:
            readOnly: true
            openWorld: false
          call: "sap-commerce-pcm.get-catalog"
          with:
            catalogId: "tools.catalogId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-categories
          description: "List product categories within a catalog version."
          hints:
            readOnly: true
            openWorld: true
          call: "sap-commerce-pcm.list-categories"
          with:
            catalogId: "tools.catalogId"
            catalogVersionId: "tools.catalogVersionId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: search-products
          description: "Search the product catalog for content management review."
          hints:
            readOnly: true
            openWorld: true
          call: "sap-commerce-occ.search-products"
          outputParameters:
            - type: object
              mapping: "$."
        - name: search-customers
          description: "Search for customer accounts to assist through the ASM interface."
          hints:
            readOnly: true
            openWorld: true
          call: "sap-commerce-asm.search-customers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-support-ticket
          description: "Create a customer support ticket for order or product issues."
          hints:
            readOnly: false
            idempotent: false
          call: "sap-commerce-asm.create-ticket"
          with:
            customerId: "tools.customerId"
            subject: "tools.subject"
            message: "tools.message"
          outputParameters:
            - type: object
              mapping: "$."