Mews Distributor API — Hotel and Availability

naftiko: 1.0.0-alpha2
info:
  label: Mews Distributor API — Hotel and Availability
  description: Self-contained Naftiko capability for the Mews Distributor surface — the legacy booking widget
    backend that returns hotel info, availability, pricing, voucher validation, and reservation pricing for
    a single property.
  tags:
  - Mews
  - Hospitality
  - Distributor
  - Booking
  - Availability
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    MEWS_DISTRIBUTOR_CONFIGURATION_ID: MEWS_DISTRIBUTOR_CONFIGURATION_ID
capability:
  consumes:
  - type: http
    namespace: distributor-availability
    baseUri: https://api.mews.com
    description: Mews Distributor — hotel content and availability.
    resources:
    - name: hotels
      path: /api/distributor/v1/hotels
      operations:
      - name: get
        method: POST
        description: Returns hotel/property metadata.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: getAvailability
        method: POST
        description: Returns availability and pricing across categories for a date range.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: vouchers
      path: /api/distributor/v1/vouchers
      operations:
      - name: validate
        method: POST
        description: Validates a voucher code for the property.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: reservationGroups
      path: /api/distributor/v1/reservationGroups
      operations:
      - name: create
        method: POST
        description: Creates a reservation group on the distributor surface.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: body
      description: Mews Distributor requests are scoped to a public ConfigurationId.
      keys:
        ConfigurationId: '{{env.MEWS_DISTRIBUTOR_CONFIGURATION_ID}}'
  exposes:
  - type: mcp
    namespace: distributor-availability-mcp
    port: 9090
    transport: http
    description: MCP adapter for the Mews Distributor surface.
    tools:
    - name: mews-distributor-get-hotel
      description: Get hotel info from Mews Distributor.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: distributor-availability.get
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-distributor-get-availability
      description: Get availability and pricing from Mews Distributor.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: distributor-availability.getAvailability
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mews-distributor-validate-voucher
      description: Validate a voucher code via Mews Distributor.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: distributor-availability.validate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.