naftiko: 1.0.0-alpha2
info:
  label: Mercedes-Benz Car Configurator API — Configurations
  description: 'Mercedes-Benz Car Configurator API — Configurations. Initial and per-id model configurations,
    alternatives, and selectable component lookup. Self-contained Naftiko capability.'
  tags:
  - Mercedes-Benz
  - Configurator
  - Configuration
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    MERCEDES_BENZ_API_KEY: MERCEDES_BENZ_API_KEY
capability:
  consumes:
  - type: http
    namespace: configurator-configurations
    baseUri: https://api.mercedes-benz.com
    description: Mercedes-Benz Car Configurator configuration engine — initial state, per-id state, alternatives,
      and selectables.
    resources:
    - name: initial-configuration
      path: /configurator/v1/markets/{marketId}/models/{modelId}/configurations/initial
      operations:
      - name: getinitialconfiguration
        method: GET
        description: Get the initial configuration for the given marketId and modelId.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: configuration
      path: /configurator/v1/markets/{marketId}/models/{modelId}/configurations/{configurationId}
      operations:
      - name: getconfiguration
        method: GET
        description: Get the configuration for the given marketId, modelId and configurationId.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: alternatives
      path: /configurator/v1/markets/{marketId}/models/{modelId}/configurations/{configurationId}/alternatives/{componentList}
      operations:
      - name: getalternatives
        method: GET
        description: Get the alternatives for the given marketId, modelId, configurationId and componentList.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: selectables
      path: /configurator/v1/markets/{marketId}/models/{modelId}/configurations/{configurationId}/selectables
      operations:
      - name: getselectables
        method: GET
        description: Get the selectable components for the given marketId, modelId and configurationId.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: productgroups
      path: /configurator/v1/markets/{marketId}/productgroups
      operations:
      - name: listproductgroups
        method: GET
        description: Get all configured active product groups for the given marketId.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
    authentication:
      type: apikey
      key: apikey
      value: '{{env.MERCEDES_BENZ_API_KEY}}'
      placement: query
  exposes:
  - type: rest
    namespace: configurator-configurations-rest
    port: 8080
    description: REST adapter for Mercedes-Benz configurator configuration operations.
    resources:
    - path: /v1/markets/{market-id}/models/{model-id}/configurations/initial
      name: initial-configuration
      description: Initial model configuration.
      operations:
      - method: GET
        name: getinitialconfiguration
        description: Get Initial Vehicle Configuration
        call: configurator-configurations.getinitialconfiguration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markets/{market-id}/models/{model-id}/configurations/{configuration-id}
      name: configuration
      description: Specific configuration by id.
      operations:
      - method: GET
        name: getconfiguration
        description: Get Vehicle Configuration By ID
        call: configurator-configurations.getconfiguration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markets/{market-id}/models/{model-id}/configurations/{configuration-id}/alternatives/{component-list}
      name: alternatives
      description: Configuration alternatives for given components.
      operations:
      - method: GET
        name: getalternatives
        description: Get Configuration Alternatives
        call: configurator-configurations.getalternatives
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markets/{market-id}/models/{model-id}/configurations/{configuration-id}/selectables
      name: selectables
      description: Selectable components for a configuration.
      operations:
      - method: GET
        name: getselectables
        description: Get Selectable Components
        call: configurator-configurations.getselectables
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markets/{market-id}/productgroups
      name: productgroups
      description: Active product groups for a market.
      operations:
      - method: GET
        name: listproductgroups
        description: List Active Product Groups
        call: configurator-configurations.listproductgroups
        outputParameters:
        - type: array
          mapping: $.
  - type: mcp
    namespace: configurator-configurations-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing Mercedes-Benz configuration engine as read-only tools.
    tools:
    - name: mercedes-get-initial-configuration
      description: Get the initial vehicle configuration for a market and model.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: configurator-configurations.getinitialconfiguration
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-get-configuration
      description: Get a specific vehicle configuration by id.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: configurator-configurations.getconfiguration
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-get-alternatives
      description: Get alternative components for a configuration.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: configurator-configurations.getalternatives
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-get-selectables
      description: Get the selectable components for a configuration.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: configurator-configurations.getselectables
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-list-productgroups
      description: List Mercedes-Benz active product groups for a market.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: configurator-configurations.listproductgroups
      outputParameters:
      - type: array
        mapping: $.