naftiko: 1.0.0-alpha2
info:
  label: Connector API — Reservations
  description: 'Connector API — Reservations. 16 operations. Lead operation: Add reservations. Self-contained Naftiko capability
    covering one Mews business surface.'
  tags:
  - Mews
  - Reservations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MEWS_API_KEY: MEWS_API_KEY
capability:
  consumes:
  - type: http
    namespace: connector-reservations
    baseUri: https://api.mews.com
    description: Connector API — Reservations business capability. Self-contained, no shared references.
    resources:
    - name: api-connector-v1-reservations-add
      path: /api/connector/v1/reservations/add
      operations:
      - name: reservationsadd
        method: POST
        description: Add reservations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-addCompanion
      path: /api/connector/v1/reservations/addCompanion
      operations:
      - name: reservationsaddcompanion
        method: POST
        description: Add reservation companion
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-addProduct
      path: /api/connector/v1/reservations/addProduct
      operations:
      - name: reservationsaddproduct
        method: POST
        description: Add reservation product
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-cancel
      path: /api/connector/v1/reservations/cancel
      operations:
      - name: reservationscancel
        method: POST
        description: Cancel reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-confirm
      path: /api/connector/v1/reservations/confirm
      operations:
      - name: reservationsconfirm
        method: POST
        description: Confirm reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-deleteCompanion
      path: /api/connector/v1/reservations/deleteCompanion
      operations:
      - name: reservationsdeletecompanion
        method: POST
        description: Delete reservation companion
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-getAll
      path: /api/connector/v1/reservations/getAll
      operations:
      - name: reservationsgetall
        method: POST
        description: Get all reservations (ver 2017-04-12)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-getAll-2023-06-06
      path: /api/connector/v1/reservations/getAll/2023-06-06
      operations:
      - name: reservationsgetall20230606
        method: POST
        description: Get all reservations (ver 2023-06-06)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-getAllItems
      path: /api/connector/v1/reservations/getAllItems
      operations:
      - name: reservationsgetallitems
        method: POST
        description: Get all reservation items
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-getChannelManagerDetails
      path: /api/connector/v1/reservations/getChannelManagerDetails
      operations:
      - name: reservationsgetchannelmanagerdetails
        method: POST
        description: Get reservation channel manager details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-price
      path: /api/connector/v1/reservations/price
      operations:
      - name: reservationsprice
        method: POST
        description: Price reservations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-process
      path: /api/connector/v1/reservations/process
      operations:
      - name: reservationsprocess
        method: POST
        description: Process reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-start
      path: /api/connector/v1/reservations/start
      operations:
      - name: reservationsstart
        method: POST
        description: Start reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-update
      path: /api/connector/v1/reservations/update
      operations:
      - name: reservationsupdate
        method: POST
        description: Update reservations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-updateCustomer
      path: /api/connector/v1/reservations/updateCustomer
      operations:
      - name: reservationsupdatecustomer
        method: POST
        description: Update reservation customer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-connector-v1-reservations-updateInterval
      path: /api/connector/v1/reservations/updateInterval
      operations:
      - name: reservationsupdateinterval
        method: POST
        description: Update reservation interval
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
  exposes:
  - type: rest
    namespace: connector-reservations-rest
    port: 8080
    description: REST adapter for Connector API — Reservations. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/connector/v1/reservations/add
      name: api-connector-v1-reservations-add
      description: REST surface for api-connector-v1-reservations-add.
      operations:
      - method: POST
        name: reservationsadd
        description: Add reservations
        call: connector-reservations.reservationsadd
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/addcompanion
      name: api-connector-v1-reservations-addcompanion
      description: REST surface for api-connector-v1-reservations-addCompanion.
      operations:
      - method: POST
        name: reservationsaddcompanion
        description: Add reservation companion
        call: connector-reservations.reservationsaddcompanion
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/addproduct
      name: api-connector-v1-reservations-addproduct
      description: REST surface for api-connector-v1-reservations-addProduct.
      operations:
      - method: POST
        name: reservationsaddproduct
        description: Add reservation product
        call: connector-reservations.reservationsaddproduct
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/cancel
      name: api-connector-v1-reservations-cancel
      description: REST surface for api-connector-v1-reservations-cancel.
      operations:
      - method: POST
        name: reservationscancel
        description: Cancel reservation
        call: connector-reservations.reservationscancel
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/confirm
      name: api-connector-v1-reservations-confirm
      description: REST surface for api-connector-v1-reservations-confirm.
      operations:
      - method: POST
        name: reservationsconfirm
        description: Confirm reservation
        call: connector-reservations.reservationsconfirm
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/deletecompanion
      name: api-connector-v1-reservations-deletecompanion
      description: REST surface for api-connector-v1-reservations-deleteCompanion.
      operations:
      - method: POST
        name: reservationsdeletecompanion
        description: Delete reservation companion
        call: connector-reservations.reservationsdeletecompanion
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/getall
      name: api-connector-v1-reservations-getall
      description: REST surface for api-connector-v1-reservations-getAll.
      operations:
      - method: POST
        name: reservationsgetall
        description: Get all reservations (ver 2017-04-12)
        call: connector-reservations.reservationsgetall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/getall/2023-06-06
      name: api-connector-v1-reservations-getall-2023-06-06
      description: REST surface for api-connector-v1-reservations-getAll-2023-06-06.
      operations:
      - method: POST
        name: reservationsgetall20230606
        description: Get all reservations (ver 2023-06-06)
        call: connector-reservations.reservationsgetall20230606
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/getallitems
      name: api-connector-v1-reservations-getallitems
      description: REST surface for api-connector-v1-reservations-getAllItems.
      operations:
      - method: POST
        name: reservationsgetallitems
        description: Get all reservation items
        call: connector-reservations.reservationsgetallitems
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/getchannelmanagerdetails
      name: api-connector-v1-reservations-getchannelmanagerdetails
      description: REST surface for api-connector-v1-reservations-getChannelManagerDetails.
      operations:
      - method: POST
        name: reservationsgetchannelmanagerdetails
        description: Get reservation channel manager details
        call: connector-reservations.reservationsgetchannelmanagerdetails
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/price
      name: api-connector-v1-reservations-price
      description: REST surface for api-connector-v1-reservations-price.
      operations:
      - method: POST
        name: reservationsprice
        description: Price reservations
        call: connector-reservations.reservationsprice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/process
      name: api-connector-v1-reservations-process
      description: REST surface for api-connector-v1-reservations-process.
      operations:
      - method: POST
        name: reservationsprocess
        description: Process reservation
        call: connector-reservations.reservationsprocess
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/start
      name: api-connector-v1-reservations-start
      description: REST surface for api-connector-v1-reservations-start.
      operations:
      - method: POST
        name: reservationsstart
        description: Start reservation
        call: connector-reservations.reservationsstart
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/update
      name: api-connector-v1-reservations-update
      description: REST surface for api-connector-v1-reservations-update.
      operations:
      - method: POST
        name: reservationsupdate
        description: Update reservations
        call: connector-reservations.reservationsupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/updatecustomer
      name: api-connector-v1-reservations-updatecustomer
      description: REST surface for api-connector-v1-reservations-updateCustomer.
      operations:
      - method: POST
        name: reservationsupdatecustomer
        description: Update reservation customer
        call: connector-reservations.reservationsupdatecustomer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/reservations/updateinterval
      name: api-connector-v1-reservations-updateinterval
      description: REST surface for api-connector-v1-reservations-updateInterval.
      operations:
      - method: POST
        name: reservationsupdateinterval
        description: Update reservation interval
        call: connector-reservations.reservationsupdateinterval
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: connector-reservations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Connector API — Reservations. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: add-reservations
      description: Add reservations
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsadd
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: add-reservation-companion
      description: Add reservation companion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsaddcompanion
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: add-reservation-product
      description: Add reservation product
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsaddproduct
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-reservation
      description: Cancel reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationscancel
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: confirm-reservation
      description: Confirm reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsconfirm
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-reservation-companion
      description: Delete reservation companion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsdeletecompanion
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-reservations-ver-2017
      description: Get all reservations (ver 2017-04-12)
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsgetall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-reservations-ver-2023
      description: Get all reservations (ver 2023-06-06)
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsgetall20230606
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-reservation-items
      description: Get all reservation items
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsgetallitems
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-reservation-channel-manager-details
      description: Get reservation channel manager details
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsgetchannelmanagerdetails
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: price-reservations
      description: Price reservations
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsprice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: process-reservation
      description: Process reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsprocess
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: start-reservation
      description: Start reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsstart
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-reservations
      description: Update reservations
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsupdate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-reservation-customer
      description: Update reservation customer
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsupdatecustomer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-reservation-interval
      description: Update reservation interval
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-reservations.reservationsupdateinterval
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.