Mews Connector API — Reservations

naftiko: 1.0.0-alpha2
info:
  label: Mews Connector API — Reservations
  description: Self-contained Naftiko capability for the Mews Connector reservations surface. Covers
    listing, fetching, creating, updating, cancelling, and managing reservation groups via the JSON-over-HTTPS
    POST contract used by the Mews PMS Connector API.
  tags:
  - Mews
  - Hospitality
  - Reservations
  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-reservations
    baseUri: https://api.mews.com
    description: Mews Connector — reservations resource group.
    resources:
    - name: reservations
      path: /api/connector/v1/reservations
      operations:
      - name: getAll
        method: POST
        description: Returns reservations matching the given filter, including state, time window, customer, and pagination cursor.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Filter parameters including ClientToken, AccessToken, Client, TimeFilter, StartUtc, EndUtc, States, Limitation/Cursor.
          required: true
      - name: getAllByIds
        method: POST
        description: Returns specific reservations by Id.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: add
        method: POST
        description: Creates one or more reservations in a single reservation group.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: update
        method: POST
        description: Updates one or more reservations.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: cancel
        method: POST
        description: Cancels one or more reservations.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: body
      description: Mews Connector authenticates via JSON body tokens (ClientToken + AccessToken + Client) on every request.
      keys:
        ClientToken: '{{env.MEWS_CLIENT_TOKEN}}'
        AccessToken: '{{env.MEWS_ACCESS_TOKEN}}'
        Client: '{{env.MEWS_CLIENT}}'
  exposes:
  - type: rest
    namespace: connector-reservations-rest
    port: 8080
    description: REST adapter exposing reservation operations.
    resources:
    - path: /v1/reservations
      name: reservations
      description: Mews Connector reservation surface as REST.
      operations:
      - method: POST
        name: list
        description: List reservations (proxies reservations/getAll).
        call: connector-reservations.getAll
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create
        description: Create reservations.
        call: connector-reservations.add
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: update
        description: Update reservations.
        call: connector-reservations.update
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: cancel
        description: Cancel reservations.
        call: connector-reservations.cancel
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: connector-reservations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Mews Connector reservations.
    tools:
    - name: mews-list-reservations
      description: List Mews reservations by filter.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: connector-reservations.getAll
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-create-reservation
      description: Create one or more Mews reservations.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.add
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-cancel-reservation
      description: Cancel one or more Mews reservations.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: connector-reservations.cancel
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.