Microsoft Azure Translator Text Client — Translate

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Translator Text Client — Translate
  description: 'Microsoft Azure Translator Text Client — Translate. 1 operations. Lead operation: Microsoft Azure Post Translate.
    Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Translate
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: translator-text-client-translate
    baseUri: https://api.cognitive.microsofttranslator.com
    description: Microsoft Azure Translator Text Client — Translate business capability. Self-contained, no shared references.
    resources:
    - name: translate
      path: /translate
      operations:
      - name: microsoftazuretranslatortranslate
        method: POST
        description: Microsoft Azure Post Translate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: from
          in: query
          type: string
          description: Specifies the language of the input text. Find which languages are available to translate from by using
            the languages method. If the `from` parameter is not spe
        - name: to
          in: query
          type: array
          description: Specifies the language of the output text. Find which languages are available to translate to by using
            the languages method. For example, use `to=de` to transla
          required: true
        - name: textType
          in: query
          type: string
          description: Defines whether the text being translated is plain text or HTML text. Any HTML needs to be a well-formed,
            complete HTML element. Possible values are `plain` (de
        - name: category
          in: query
          type: string
          description: A string specifying the category (domain) of the translation. This parameter retrieves translations
            from a customized system built with Custom Translator. Defau
        - name: profanityAction
          in: query
          type: string
          description: 'Specifies how profanities should be treated in translations. Possible values are: `NoAction` (default),
            `Marked` or `Deleted`.'
        - name: profanityMarker
          in: query
          type: string
          description: Specifies how profanities should be marked in translations. Possible values are- `Asterisk` (default)
            or `Tag`.
        - name: includeAlignment
          in: query
          type: boolean
          description: Specifies whether to include alignment projection from source text to translated text. Possible values
            are- `true` or `false` (default).
        - name: includeSentenceLength
          in: query
          type: boolean
          description: Specifies whether to include sentence boundaries for the input text and the translated text. Possible
            values are- `true` or `false` (default).
        - name: suggestedFrom
          in: query
          type: string
          description: Specifies a fallback language if the language of the input text can't be identified. Language auto-detection
            is applied when the `from` parameter is omitted. If
        - name: fromScript
          in: query
          type: string
          description: Specifies the script of the input text. Supported scripts are available from the languages method
        - name: toScript
          in: query
          type: array
          description: Specifies the script of the translated text. Supported scripts are available from the languages method
        - name: X-ClientTraceId
          in: header
          type: string
          description: A client-generated GUID to uniquely identify the request. Note that you can omit this header if you
            include the trace ID in the query string using a query param
        - name: text
          in: body
          type: array
          description: '# Request body'
          required: true
  exposes:
  - type: rest
    namespace: translator-text-client-translate-rest
    port: 8080
    description: REST adapter for Microsoft Azure Translator Text Client — Translate. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/translate
      name: translate
      description: REST surface for translate.
      operations:
      - method: POST
        name: microsoftazuretranslatortranslate
        description: Microsoft Azure Post Translate
        call: translator-text-client-translate.microsoftazuretranslatortranslate
        with:
          from: rest.from
          to: rest.to
          textType: rest.textType
          category: rest.category
          profanityAction: rest.profanityAction
          profanityMarker: rest.profanityMarker
          includeAlignment: rest.includeAlignment
          includeSentenceLength: rest.includeSentenceLength
          suggestedFrom: rest.suggestedFrom
          fromScript: rest.fromScript
          toScript: rest.toScript
          X-ClientTraceId: rest.X-ClientTraceId
          text: rest.text
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: translator-text-client-translate-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Translator Text Client — Translate. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-post-translate
      description: Microsoft Azure Post Translate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: translator-text-client-translate.microsoftazuretranslatortranslate
      with:
        from: tools.from
        to: tools.to
        textType: tools.textType
        category: tools.category
        profanityAction: tools.profanityAction
        profanityMarker: tools.profanityMarker
        includeAlignment: tools.includeAlignment
        includeSentenceLength: tools.includeSentenceLength
        suggestedFrom: tools.suggestedFrom
        fromScript: tools.fromScript
        toScript: tools.toScript
        X-ClientTraceId: tools.X-ClientTraceId
        text: tools.text
      outputParameters:
      - type: object
        mapping: $.