Strategic Sourcing and Procurement

naftiko: "1.0.0-alpha1"

info:
  label: "Strategic Sourcing and Procurement"
  description: >-
    Unified capability for strategic sourcing and procurement workflows using
    the Workday Strategic Sourcing (Scout RFP) API. Enables procurement teams
    to manage the full sourcing lifecycle — from creating RFP events and
    inviting suppliers to collecting bids and making award decisions.
  tags:
    - Procurement
    - Strategic Sourcing
    - RFP
    - Supplier Management
    - Workday
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      SCOUT_RFP_API_KEY: SCOUT_RFP_API_KEY
      SCOUT_RFP_USER_TOKEN: SCOUT_RFP_USER_TOKEN
      SCOUT_RFP_USER_EMAIL: SCOUT_RFP_USER_EMAIL

capability:
  consumes:
    - import: scout-rfp-events
      location: ./shared/scout-rfp-events.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: strategic-sourcing-api
      description: "Unified REST API for end-to-end strategic sourcing and procurement workflows."
      resources:
        - path: /v1/events
          name: events
          description: Sourcing events (RFPs, RFIs, auctions)
          operations:
            - method: GET
              name: list-events
              description: List all sourcing events
              call: "scout-rfp-events.list-events"
              with:
                page_size: "rest.page_size"
                filter: "rest.filter"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-event
              description: Create a new sourcing event from a template
              call: "scout-rfp-events.create-event"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{id}
          name: event-detail
          description: Individual event management
          operations:
            - method: GET
              name: get-event
              description: Get event details
              call: "scout-rfp-events.get-event"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: PATCH
              name: update-event
              description: Update event details
              call: "scout-rfp-events.update-event"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: DELETE
              name: delete-event
              description: Delete a sourcing event
              call: "scout-rfp-events.delete-event"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/templates
          name: templates
          description: Event templates for creating standardized sourcing events
          operations:
            - method: GET
              name: list-event-templates
              description: List available event templates
              call: "scout-rfp-events.list-event-templates"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{event_id}/worksheets
          name: worksheets
          description: Worksheets within sourcing events
          operations:
            - method: GET
              name: list-worksheets
              description: List worksheets for an event
              call: "scout-rfp-events.list-worksheets"
              with:
                event_id: "rest.event_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{event_id}/line-items
          name: line-items
          description: Line items within event worksheets
          operations:
            - method: GET
              name: list-line-items
              description: List line items for an event worksheet
              call: "scout-rfp-events.list-line-items"
              with:
                event_id: "rest.event_id"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-line-item
              description: Add a line item to a worksheet
              call: "scout-rfp-events.create-line-item"
              with:
                event_id: "rest.event_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{event_id}/bids
          name: bids
          description: Supplier bids for RFP events
          operations:
            - method: GET
              name: list-bids
              description: List all bids for an event
              call: "scout-rfp-events.list-bids"
              with:
                event_id: "rest.event_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{event_id}/bids/{id}
          name: bid-detail
          description: Individual bid details
          operations:
            - method: GET
              name: get-bid
              description: Get bid details
              call: "scout-rfp-events.get-bid"
              with:
                event_id: "rest.event_id"
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: strategic-sourcing-mcp
      transport: http
      description: "MCP server for AI-assisted strategic sourcing and procurement workflows."
      tools:
        - name: list-sourcing-events
          description: List all sourcing events (RFPs, RFIs, auctions) with optional filtering
          hints:
            readOnly: true
            openWorld: true
          call: "scout-rfp-events.list-events"
          with:
            page_size: "tools.page_size"
            filter: "tools.filter"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-sourcing-event
          description: Create a new sourcing event (RFP or RFI) from an existing template
          hints:
            readOnly: false
          call: "scout-rfp-events.create-event"
          with:
            title: "tools.title"
            event_type: "tools.event_type"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-sourcing-event
          description: Get details of a specific sourcing event by ID
          hints:
            readOnly: true
          call: "scout-rfp-events.get-event"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: update-sourcing-event
          description: Update properties of an existing sourcing event
          hints:
            readOnly: false
            idempotent: true
          call: "scout-rfp-events.update-event"
          with:
            id: "tools.id"
            title: "tools.title"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-event-templates
          description: List available event templates for creating standardized RFPs
          hints:
            readOnly: true
          call: "scout-rfp-events.list-event-templates"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-worksheets
          description: List worksheets within a sourcing event
          hints:
            readOnly: true
          call: "scout-rfp-events.list-worksheets"
          with:
            event_id: "tools.event_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-line-items
          description: List line items (products/services being sourced) in an event worksheet
          hints:
            readOnly: true
          call: "scout-rfp-events.list-line-items"
          with:
            event_id: "tools.event_id"
            worksheet_id: "tools.worksheet_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-line-item
          description: Add a line item to a sourcing event worksheet
          hints:
            readOnly: false
          call: "scout-rfp-events.create-line-item"
          with:
            event_id: "tools.event_id"
            worksheet_id: "tools.worksheet_id"
            name: "tools.name"
            description: "tools.description"
            quantity: "tools.quantity"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-bids
          description: List supplier bids submitted for an RFP event
          hints:
            readOnly: true
          call: "scout-rfp-events.list-bids"
          with:
            event_id: "tools.event_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-bid
          description: Get details of a specific supplier bid
          hints:
            readOnly: true
          call: "scout-rfp-events.get-bid"
          with:
            event_id: "tools.event_id"
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."