naftiko: 1.0.0-alpha2
info:
  label: Convai TTS API — Text to Speech
  description: 'Convai TTS — synthesize speech from text using the Convai voice catalog. 3 operations. Lead
    operation: Convai Synthesize Speech.'
  tags:
  - Convai
  - TTS
  - Speech
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    CONVAI_API_KEY: CONVAI_API_KEY
capability:
  consumes:
  - type: http
    namespace: tts-tts
    baseUri: https://api.convai.com
    description: Convai TTS business surface.
    resources:
    - name: tts
      path: /tts
      operations:
      - name: synthesize
        method: POST
        description: Convai Synthesize Speech
        outputRawFormat: bytes
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: tts-voices
      path: /tts/get_available_voices
      operations:
      - name: listvoices
        method: GET
        description: Convai List Available Voices
        outputRawFormat: json
    - name: tts-languages
      path: /tts/get_available_languages
      operations:
      - name: listlanguages
        method: GET
        description: Convai List Available Languages
        outputRawFormat: json
    authentication:
      type: apikey
      key: CONVAI-API-KEY
      value: '{{env.CONVAI_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: tts-mcp
    port: 9090
    transport: http
    description: MCP adapter for Convai TTS.
    tools:
    - name: convai-synthesize-speech
      description: Convai Synthesize Speech from a transcript and selected voice.
      call: tts-tts.synthesize
      with:
        body: tools.body
    - name: convai-list-voices
      description: Convai List Available Voices
      hints:
        readOnly: true
        idempotent: true
      call: tts-tts.listvoices
    - name: convai-list-languages
      description: Convai List Available Languages
      hints:
        readOnly: true
        idempotent: true
      call: tts-tts.listlanguages