naftiko: 1.0.0-alpha2
info:
  label: Mercedes-Benz Remote Diagnostic Support API — Readouts
  description: 'Mercedes-Benz Remote Diagnostic Support API — Readouts. Create asynchronous readouts of DTCs, DTC
    snapshots, ECUs, and available resources for a specific VIN/FIN. Self-contained Naftiko capability.'
  tags:
  - Mercedes-Benz
  - Diagnostics
  - DTC
  - ECU
  - Telematics
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    MERCEDES_BENZ_ACCESS_TOKEN: MERCEDES_BENZ_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: remote-diagnostic-support-readouts
    baseUri: https://api.mercedes-benz.com
    description: Mercedes-Benz Remote Diagnostic Support readouts — DTC, DTC snapshot, ECU, and resource readouts
      for a vehicle.
    resources:
    - name: dtc-readouts
      path: /remotediagnostic/v1/vehicles/{vehicleId}/dtcReadouts
      operations:
      - name: createdtcreadout
        method: POST
        description: Create a readout of Diagnostic Trouble Codes for a vehicle.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: dtc-snapshot-readouts
      path: /remotediagnostic/v1/vehicles/{vehicleId}/ecuId/{ecuId}/dtcId/{dtcId}/dtcSnapshotReadouts
      operations:
      - name: createdtcsnapshotreadout
        method: POST
        description: Create a readout of a DTC snapshot for an ECU and DTC.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ecu-readouts
      path: /remotediagnostic/v1/vehicles/{vehicleId}/ecuReadouts
      operations:
      - name: createecureadout
        method: POST
        description: Create a readout of Electronic Control Units for a vehicle.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: resource-readouts
      path: /remotediagnostic/v1/vehicles/{vehicleId}/resourceReadouts
      operations:
      - name: createresourcereadout
        method: POST
        description: Create a readout of available resources accessible to the requesting party for a vehicle.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      value: '{{env.MERCEDES_BENZ_ACCESS_TOKEN}}'
  exposes:
  - type: rest
    namespace: remote-diagnostic-support-readouts-rest
    port: 8080
    description: REST adapter for Mercedes-Benz Remote Diagnostic Support readouts.
    resources:
    - path: /v1/vehicles/{vehicle-id}/dtc-readouts
      name: dtc-readouts
      description: REST surface for DTC readouts.
      operations:
      - method: POST
        name: createdtcreadout
        description: Create DTC Readout For Vehicle
        call: remote-diagnostic-support-readouts.createdtcreadout
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vehicles/{vehicle-id}/ecu/{ecu-id}/dtc/{dtc-id}/snapshot-readouts
      name: dtc-snapshot-readouts
      description: REST surface for DTC snapshot readouts.
      operations:
      - method: POST
        name: createdtcsnapshotreadout
        description: Create DTC Snapshot Readout
        call: remote-diagnostic-support-readouts.createdtcsnapshotreadout
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vehicles/{vehicle-id}/ecu-readouts
      name: ecu-readouts
      description: REST surface for ECU readouts.
      operations:
      - method: POST
        name: createecureadout
        description: Create ECU Readout For Vehicle
        call: remote-diagnostic-support-readouts.createecureadout
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vehicles/{vehicle-id}/resource-readouts
      name: resource-readouts
      description: REST surface for resource readouts.
      operations:
      - method: POST
        name: createresourcereadout
        description: Create Resource Readout For Vehicle
        call: remote-diagnostic-support-readouts.createresourcereadout
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: remote-diagnostic-support-readouts-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing Mercedes-Benz Remote Diagnostic Support as agent tools.
    tools:
    - name: mercedes-create-dtc-readout
      description: Create a readout of Diagnostic Trouble Codes for a Mercedes-Benz vehicle by VIN.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: remote-diagnostic-support-readouts.createdtcreadout
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-create-dtc-snapshot-readout
      description: Create a DTC snapshot readout for a specific ECU and DTC.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: remote-diagnostic-support-readouts.createdtcsnapshotreadout
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-create-ecu-readout
      description: Create an ECU inventory readout for a Mercedes-Benz vehicle by VIN.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: remote-diagnostic-support-readouts.createecureadout
      outputParameters:
      - type: object
        mapping: $.
    - name: mercedes-create-resource-readout
      description: Create a readout of available diagnostic resources for a Mercedes-Benz vehicle by VIN.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: remote-diagnostic-support-readouts.createresourcereadout
      outputParameters:
      - type: object
        mapping: $.