Mews Connector API — Bills, Payments, and Accounting

naftiko: 1.0.0-alpha2
info:
  label: Mews Connector API — Bills, Payments, and Accounting
  description: Self-contained Naftiko capability for the Mews Connector finance surface — bills, accounting
    items, payments, and accounting categories.
  tags:
  - Mews
  - Hospitality
  - Billing
  - Payments
  - Accounting
  - Finance
  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-bills
    baseUri: https://api.mews.com
    description: Mews Connector — bills and accounting.
    resources:
    - name: bills
      path: /api/connector/v1/bills
      operations:
      - name: getAll
        method: POST
        description: Returns bills filtered by state, customer, time window, or company.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: close
        method: POST
        description: Closes one or more bills.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: accountingItems
      path: /api/connector/v1/accountingItems
      operations:
      - name: getAll
        method: POST
        description: Returns accounting items (revenue and payment items) filtered by bill, customer, or time window.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: payments
      path: /api/connector/v1/payments
      operations:
      - name: add
        method: POST
        description: Records a payment against a customer account or bill.
        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-bills-mcp
    port: 9090
    transport: http
    description: MCP adapter for Mews bills, accounting items, and payments.
    tools:
    - name: mews-list-bills
      description: List Mews bills by filter.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: connector-bills.getAll
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-close-bill
      description: Close one or more Mews bills.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: connector-bills.close
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-add-payment
      description: Record a Mews payment.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-bills.add
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.