kurdish-tts-stt

endpoint

https://www.kurdishtts.com/api/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing

karma

0 · newcomer

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_plan open 4h ago

  Show what this connection may use. With an API key: your current plan, remaining allowance, which model_versions and speaker ids you may render. Without a key: the purchasable plan ladder and how to get a key. Free, no credits consumed. Call this FIRST when any tool returns a 401 or 403 — it is the fastest way to learn what went wrong.

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• list_dialects open 4h ago

  List the supported Kurdish dialects and their scripts. Static capability descriptor — costs nothing and needs no API key.

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• list_voices open 4h ago

  List available Kurdish text-to-speech voices. Returns speaker ids to use with synthesize_speech. Free metadata call — no credits consumed, no API key needed. Defaults to model_version "v3", the SAME default synthesize_speech uses — pass the same model_version to both, because a speaker id from one catalog does not exist in another. Results are paginated; the response reports total_count and which ids a free plan may render.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 200,
        "minimum": 1,
        "description": "Maximum voices to return. Default 25."
      },
      "gender": {
        "enum": [
          "male",
          "female"
        ],
        "type": "string",
        "description": "Filter by voice gender."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "description": "Number of voices to skip, for paging. Default 0."
      },
      "dialect": {
        "enum": [
          "sorani",
          "kurmanji",
          "badini"
        ],
        "type": "string",
        "description": "Filter by dialect."
      },
      "model_version": {
        "enum": [
          "v3",
          "v4",
          "v5"
        ],
        "type": "string",
        "description": "Voice catalog. Default \"v3\", matching synthesize_speech. v3 is the compatibility catalog; v4 is the large catalog (hundreds of voices); v5 is the curated catalog plus Cast and Studio voices, and requires a paid API plan."
      }
    },
    "additionalProperties": false
  }

  arguments 44 lines copy
• synthesize_speech unknown never probed

  Convert Kurdish text (Sorani or Kurmanji) to speech audio. Requires a TTS API key; characters are billed against your plan. Get speaker_id from list_voices called with the SAME model_version you pass here (default "v3") — ids are not shared between catalogs. Returns one complete clip: MCP cannot stream, so for a live voice agent call POST https://www.kurdishtts.com/api/tts-stream directly instead (SSE, first audio in ~1s). Max 4000 characters per call in the default mp3 container, 600 with format "wav"; free plans are capped at 500 server-side. Note: speed is caller-facing (higher = faster).

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "text",
      "speaker_id"
    ],
    "properties": {
      "text": {
        "type": "string",
        "maxLength": 4000,
        "minLength": 1,
        "description": "Kurdish text to synthesize. Max 4000 characters (only 600 if you set format \"wav\"); free plans are capped at 500."
      },
      "speed": {
        "type": "number",
        "maximum": 4,
        "minimum": 0.25,
        "description": "Playback speed, higher = faster. Default 1."
      },
      "format": {
        "enum": [
          "mp3",
          "opus",
          "wav"
        ],
        "type": "string",
        "description": "Audio container. Default \"mp3\". Audio is returned base64-encoded inside the tool result, so the container decides how much of your context it costs: for identical speech, mp3 is ~7.5x smaller than wav and opus ~11.5x. Choose \"wav\" only when you need uncompressed audio, and keep the text under 600 characters if you do."
      },
      "dialect": {
        "enum": [
          "sorani",
          "kurmanji",
          "badini"
        ],
        "type": "string",
        "description": "Language the text is in. Normally inferred from the speaker_id prefix and safe to omit. REQUIRED to get a correct Kurmanji read from a Cast or Studio voice (cast_*, studio_*): those are tagged sorani after their reference clip but read Sorani and Kurmanji, so without this they pronounce Kurmanji with Sorani phonetics. \"badini\" is valid only with one of the six badini_ voices — pairing it with any other voice is refused with a 400."
      },
      "speaker_id": {
        "type": "string",
        "description": "Voice id from list_voices, e.g. \"sorani_85\" or \"kurmanji_6\" on the default \"v3\" catalog. Dialect is derived from the prefix. Must come from the same model_version you pass below."
      },
      "model_version": {
        "enum": [
          "v3",
          "v4",
          "v5"
        ],
        "type": "string",
        "description": "Voice catalog and plan entitlement. Default \"v3\". Explicit \"v5\" and the Cast/Studio voices require a paid API plan."
      },
      "include_timestamps": {
        "type": "boolean",
        "description": "Return JSON with word-level timestamps instead of an audio block. NOTE: the audio in that JSON is headerless raw PCM16 (24kHz mono), not a WAV file — add a WAV header before saving it, or it will not play."
      }
    },
    "additionalProperties": false
  }

  arguments 58 lines copy
• transcribe_audio unknown never probed

  Transcribe Kurdish audio (Sorani or Kurmanji) to text. Requires an STT API key; usage is metered per audio minute against your plan. IMPORTANT: dialect selects the decoder and nothing detects it for you — transcribing Sorani audio as Kurmanji returns fluent, confident, WRONG text with no error. Pass dialect "auto" when you are not certain, and pick the coherent transcript from the two it returns. Max 3MB of decoded audio over MCP (~90s of 16kHz WAV, but ~25 minutes of 64kbps MP3 — send compressed audio to fit more); for larger files call POST https://www.kurdishtts.com/api/stt-proxy directly (multipart).

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "audio_base64",
      "dialect"
    ],
    "properties": {
      "dialect": {
        "enum": [
          "sorani",
          "kurmanji",
          "auto"
        ],
        "type": "string",
        "description": "Which decoder to run. \"sorani\" or \"kurmanji\" when you know the dialect. \"auto\" transcribes with BOTH and returns both transcripts so you can choose — it bills the audio twice, so prefer a known dialect when you have one."
      },
      "filename": {
        "type": "string",
        "description": "Original filename, used to infer the format. Default audio.wav."
      },
      "mime_type": {
        "type": "string",
        "description": "Audio MIME type. Default audio/wav."
      },
      "audio_base64": {
        "type": "string",
        "maxLength": 4194308,
        "minLength": 1,
        "description": "Base64-encoded audio file (WAV, MP3, FLAC, OGG or M4A). Max 3MB decoded — compressed formats fit far more speech in that budget than WAV does."
      }
    },
    "additionalProperties": false
  }

  arguments 34 lines copy
• start_streaming_transcription unknown never probed

  Open a live speech-to-text session for LISTENING — a microphone or audio stream you transcribe in real time. This does NOT make anything speak; to speak Kurdish use synthesize_speech, or POST https://www.kurdishtts.com/api/tts-stream for progressive audio. WARNING: calling this immediately consumes one streaming session from your STT plan quota — only call it when you are ready to connect. Returns a websocket_url: open it, stream PCM16 mono 16kHz audio chunks, send {"type": "finalize"} to flush and {"type": "done"} to close. Session duration is limited by plan.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "dialect"
    ],
    "properties": {
      "dialect": {
        "enum": [
          "sorani",
          "kurmanji"
        ],
        "type": "string",
        "description": "Dialect that will be spoken."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.