naftiko: 1.0.0-alpha2
info:
  label: Mews Connector API — Customers
  description: Self-contained Naftiko capability for Mews Connector customer/guest profile management,
    including identity documents, addresses, classifications, and merging.
  tags:
  - Mews
  - Hospitality
  - Customers
  - Guests
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    MEWS_CLIENT_TOKEN: MEWS_CLIENT_TOKEN
    MEWS_ACCESS_TOKEN: MEWS_ACCESS_TOKEN
    MEWS_CLIENT: MEWS_CLIENT
capability:
  consumes:
  - type: http
    namespace: connector-customers
    baseUri: https://api.mews.com
    description: Mews Connector — customers resource group.
    resources:
    - name: customers
      path: /api/connector/v1/customers
      operations:
      - name: getAll
        method: POST
        description: Returns customers matching the given filter parameters.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: add
        method: POST
        description: Creates a new customer profile.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: update
        method: POST
        description: Updates a customer profile.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: merge
        method: POST
        description: Merges two customer profiles, keeping the target identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: body
      description: Mews Connector body-token authentication.
      keys:
        ClientToken: '{{env.MEWS_CLIENT_TOKEN}}'
        AccessToken: '{{env.MEWS_ACCESS_TOKEN}}'
        Client: '{{env.MEWS_CLIENT}}'
  exposes:
  - type: mcp
    namespace: connector-customers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Mews Connector customers.
    tools:
    - name: mews-list-customers
      description: Search/list Mews customers.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: connector-customers.getAll
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-add-customer
      description: Create a new Mews customer.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-customers.add
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-merge-customers
      description: Merge two Mews customer profiles.
      hints:
        readOnly: false
        destructive: true
        idempotent: false
      call: connector-customers.merge
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.