naftiko: 1.0.0-alpha2
info:
  label: Salla Merchant API — Customers
  description: Salla Merchant API Customers capability — list, create, get, and update customers via
    https://api.salla.dev/admin/v2.
  tags:
  - Salla
  - Customers
  - E-Commerce
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    SALLA_ACCESS_TOKEN: SALLA_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: merchant-customers
    baseUri: https://api.salla.dev/admin/v2
    description: Salla Merchant API — Customers business capability.
    resources:
    - name: customers
      path: /customers
      operations:
      - name: listCustomers
        method: GET
        description: List customers.
        inputParameters:
        - { name: page, in: query, type: integer }
        - { name: per_page, in: query, type: integer }
        outputParameters:
        - { name: result, type: object, value: $. }
      - name: createCustomer
        method: POST
        description: Create a customer.
        inputParameters:
        - { name: body, in: body, type: object, required: true }
        outputParameters:
        - { name: result, type: object, value: $. }
    - name: customer
      path: /customers/{customer_id}
      operations:
      - name: getCustomer
        method: GET
        description: Get customer details.
        inputParameters:
        - { name: customer_id, in: path, type: integer, required: true }
        outputParameters:
        - { name: result, type: object, value: $. }
      - name: updateCustomer
        method: PUT
        description: Update a customer.
        inputParameters:
        - { name: customer_id, in: path, type: integer, required: true }
        - { name: body, in: body, type: object, required: true }
        outputParameters:
        - { name: result, type: object, value: $. }
    authentication:
      type: bearer
      value: '{{env.SALLA_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: merchant-customers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Salla Customers capability.
    tools:
    - name: salla-list-customers
      description: List Salla customers.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: merchant-customers.listCustomers
    - name: salla-get-customer
      description: Get a Salla customer by ID.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: merchant-customers.getCustomer
      with: { customer_id: tools.customer_id }
    - name: salla-create-customer
      description: Create a Salla customer.
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: merchant-customers.createCustomer
      with: { body: tools.body }