Connector API — Rates

naftiko: 1.0.0-alpha2
info:
  label: Connector API — Rates
  description: 'Connector API — Rates. 7 operations. Lead operation: Add rates. Self-contained Naftiko capability covering
    one Mews business surface.'
  tags:
  - Mews
  - Rates
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MEWS_API_KEY: MEWS_API_KEY
capability:
  consumes:
  - type: http
    namespace: connector-rates
    baseUri: https://api.mews.com
    description: Connector API — Rates business capability. Self-contained, no shared references.
    resources:
    - name: api-connector-v1-rates-add
      path: /api/connector/v1/rates/add
      operations:
      - name: ratesadd
        method: POST
        description: Add rates
        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-rates-delete
      path: /api/connector/v1/rates/delete
      operations:
      - name: ratesdelete
        method: POST
        description: Delete rates
        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-rates-getAll
      path: /api/connector/v1/rates/getAll
      operations:
      - name: ratesgetall
        method: POST
        description: Get all rates
        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-rates-getPricing
      path: /api/connector/v1/rates/getPricing
      operations:
      - name: ratesgetpricing
        method: POST
        description: Get rate pricing
        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-rates-set
      path: /api/connector/v1/rates/set
      operations:
      - name: ratesset
        method: POST
        description: Set rates
        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-rates-updateCapacityOffset
      path: /api/connector/v1/rates/updateCapacityOffset
      operations:
      - name: ratesupdatecapacityoffset
        method: POST
        description: Update rate capacity offset pricing
        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-rates-updatePrice
      path: /api/connector/v1/rates/updatePrice
      operations:
      - name: ratesupdateprice
        method: POST
        description: Update rate price
        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-rates-rest
    port: 8080
    description: REST adapter for Connector API — Rates. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/connector/v1/rates/add
      name: api-connector-v1-rates-add
      description: REST surface for api-connector-v1-rates-add.
      operations:
      - method: POST
        name: ratesadd
        description: Add rates
        call: connector-rates.ratesadd
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/delete
      name: api-connector-v1-rates-delete
      description: REST surface for api-connector-v1-rates-delete.
      operations:
      - method: POST
        name: ratesdelete
        description: Delete rates
        call: connector-rates.ratesdelete
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/getall
      name: api-connector-v1-rates-getall
      description: REST surface for api-connector-v1-rates-getAll.
      operations:
      - method: POST
        name: ratesgetall
        description: Get all rates
        call: connector-rates.ratesgetall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/getpricing
      name: api-connector-v1-rates-getpricing
      description: REST surface for api-connector-v1-rates-getPricing.
      operations:
      - method: POST
        name: ratesgetpricing
        description: Get rate pricing
        call: connector-rates.ratesgetpricing
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/set
      name: api-connector-v1-rates-set
      description: REST surface for api-connector-v1-rates-set.
      operations:
      - method: POST
        name: ratesset
        description: Set rates
        call: connector-rates.ratesset
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/updatecapacityoffset
      name: api-connector-v1-rates-updatecapacityoffset
      description: REST surface for api-connector-v1-rates-updateCapacityOffset.
      operations:
      - method: POST
        name: ratesupdatecapacityoffset
        description: Update rate capacity offset pricing
        call: connector-rates.ratesupdatecapacityoffset
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/connector/v1/rates/updateprice
      name: api-connector-v1-rates-updateprice
      description: REST surface for api-connector-v1-rates-updatePrice.
      operations:
      - method: POST
        name: ratesupdateprice
        description: Update rate price
        call: connector-rates.ratesupdateprice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: connector-rates-mcp
    port: 9090
    transport: http
    description: MCP adapter for Connector API — Rates. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: add-rates
      description: Add rates
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-rates.ratesadd
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-rates
      description: Delete rates
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-rates.ratesdelete
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-rates
      description: Get all rates
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-rates.ratesgetall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-rate-pricing
      description: Get rate pricing
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: connector-rates.ratesgetpricing
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: set-rates
      description: Set rates
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-rates.ratesset
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-rate-capacity-offset-pricing
      description: Update rate capacity offset pricing
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-rates.ratesupdatecapacityoffset
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-rate-price
      description: Update rate price
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: connector-rates.ratesupdateprice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.