Tapra MCP server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TAPRA_API_KEY | Yes | Your Tapra API key (starts with tapra_sk_live_…). Required. | |
| TAPRA_API_URL | No | Force an API origin, e.g. http://127.0.0.1:8787 for a local model host. Default: read from tapra.tn. | |
| TAPRA_SITE_URL | No | Website serving the price list, balance, and the current API address. Default: https://tapra.tn. | |
| TAPRA_BASE_PATH | No | Input files must be inside this folder; relative paths resolve here. Default: home folder. | |
| TAPRA_OUTPUT_DIR | No | Where generated files go; outputs can't be written anywhere else. Default: ~/Tapra. | |
| TAPRA_FFMPEG_PATH | No | Path to ffmpeg if it is not on PATH. Default: ffmpeg. | |
| TAPRA_AUDIO_PLAYER | No | Program play_audio runs as <player> <file>. Default: ffplay, then the system player. | |
| TAPRA_MAX_COST_TND | No | Refuse any single call estimated above this amount. Default: none. | |
| TAPRA_MCP_OUTPUT_MODE | No | Output mode: files saves results; resources returns them inline only (nothing saved); both does both. Default: files. | |
| TAPRA_TIMEOUT_SECONDS | No | Per-request timeout. Default: 600. | |
| TAPRA_MCP_MAX_INLINE_MB | No | Largest file returned inline in resources / both mode. Default: 15. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tapra_statusA | Check the Tapra connection: API health, available models, current prices, output folder, and whether ffmpeg is installed. Free. Call this first when a tool fails. |
| list_voicesA | List the Tapra voices for text_to_speech and create_voiceover, with a description of each. Free. Also answers questions about voice cloning, which is not currently available. |
| get_balanceA | Show the Tapra balance (TND), total spent, and the 10 most recent charges for this API key. Free. |
| speech_to_textA | Transcribe an audio or video file with Tapra, which handles Tunisian Derja mixed with French and English. One call writes a folder with the transcript as txt, srt and vtt (plus a .json with full timings). Speakers are labelled by default (no extra charge): the result says how many were detected, with talk time, a quote and an audio clip of each, and a speakers.html page. When there are several speakers, ask the user whether to name them, then call name_speakers. Long files are split into chunks automatically. Costs money per minute of audio. |
| transcribe_videoA | Make subtitles for a video: extracts the audio, transcribes Derja/French/English, and writes srt, vtt and txt in one go, timed for reading. Speakers are labelled and colored by default (no extra charge), with a speaker report and a clip of each voice; when there are several, ask the user whether to name them, then call name_speakers. Set burn_subtitles to also render a copy of the video with the subtitles drawn in. Needs ffmpeg. Costs money per minute. |
| name_speakersA | Give the speakers found by speech_to_text or transcribe_video real names (and optionally colors), then rewrite the txt, srt and vtt with those names. Each speaker keeps one subtitle color (srt colors, vtt voice styles). Labels given the same name are merged into one speaker. Free, works offline. Can also burn the named subtitles into the video. |
| diarize_audioA | Find speaker turns in an audio or video file (no transcript). Returns each turn with its speaker and times. Costs money per minute. |
| text_to_speechA | Speak text in Tunisian Derja (Arabic script or Arabizi), French, English, or a mix with one of the Tapra voices, with Tunisian pronunciation. Voices: amal = Mature woman. Warm, grounded, everyday Tunisian.; salma = Younger woman. Lighter and brighter, conversational.; salah = Man with a big, sharp (aigu) voice that carries. Strong presence.; fahmi = Middle-aged man. Normal, natural male voice.; leo = Young man. Light and energetic. The default Tapra voice.. Add non-verbal effects inline with tags (not billed): [euh] breathy hesitation; [aaa] long filler while thinking; [hmm] closed-mouth "mmm"; [ahem] clears the throat; [ouf] tired sigh; [breath] out-breath, "haah"; [stutter] repeats the first sound of the next word; put it right before that word. Example: "[euh] ma na3rafch, [breath] khalli nchouf". Saves the audio in the chosen format (wav by default, 18 other formats). Voice cloning and custom voice design are not currently available: if the user asks to clone a voice, say so and offer these voices. Costs money per character. For long scripts or narration timed to a video, use create_voiceover. |
| create_voiceoverA | Turn a script or a subtitle file into one narration track for video work. Each line is spoken with the same Tapra voice (amal = Mature woman. Warm, grounded, everyday Tunisian.; salma = Younger woman. Lighter and brighter, conversational.; salah = Man with a big, sharp (aigu) voice that carries. Strong presence.; fahmi = Middle-aged man. Normal, natural male voice.; leo = Young man. Light and energetic. The default Tapra voice.; voice cloning is not available) and placed on a timeline: at its subtitle time (from srt_path) or one after another (from script or lines). Lines may use effect tags ([euh] breathy hesitation; [aaa] long filler while thinking; [hmm] closed-mouth "mmm"; [ahem] clears the throat; [ouf] tired sigh; [breath] out-breath, "haah"; [stutter] repeats the first sound of the next word; put it right before that word). Writes a folder with the voiceover track (wav or another format), one WAV clip per line, and manifest.json (text + start/end per clip) that video generation tools can follow. Optionally lays the voiceover onto a video. Reports progress per line. Costs money per character. |
| translateA | Translate between Tunisian Derja and English, French, or Modern Standard Arabic (in both directions). Call list_translation_languages for the exact target names. Costs money per character. |
| list_translation_languagesA | List the languages translate accepts as source and target. Free. |
| convert_scriptA | Convert Tunisian text between Arabizi (Latin letters and digits, e.g. "3aslema, chna7welek?") and Arabic script, in either direction. Costs money per character. |
| play_audioA | Play an audio or video file on this computer's speakers (for example a clip you just generated). Returns right away while it plays; a new play stops the previous one. Set stop to just stop playback. Free. |
| find_in_transcriptA | Find when a word or phrase is said, with timestamps, in a transcript saved by speech_to_text or transcribe_video (.json gives word-level times; .srt/.vtt give subtitle-level times). Matches Arabic script with or without harakat and letter variants (أ/ا, ة/ه, ى/ي), French accents optional, and small typos when fuzzy. Useful for cutting video ("where does he say X?"). Free, runs locally. |
| edit_audioA | Prepare audio for videos and posts, locally with ffmpeg: join several files in order, trim, remove long silences, normalize loudness (-14 LUFS for social video, -16 podcasts, -23 broadcast), fade in/out, and convert to any of the 19 formats. Video inputs contribute their sound. Writes a new file; never changes the originals. Free. |
| translate_subtitlesA | Translate an SRT or VTT file between Tunisian Derja and English, French, or MSA, keeping every timing and speaker label. Lines are sent in batches to keep cost low. Pair with create_voiceover (srt_path) to dub a video. Reports progress per batch. Costs money per character. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools have clearly distinct purposes, and the descriptions explicitly disambiguate tricky pairs (translate vs translate_subtitles, text_to_speech vs create_voiceover). The main overlap is speech_to_text vs transcribe_video (which also accepts video input and transcribes it) and diarize_audio, since speech_to_text already labels speakers — an agent could hesitate over which to call for a video file.
Everything is snake_case and mostly verb_noun (list_voices, get_balance, create_voiceover, edit_audio, find_in_transcript). A few deviate into noun-ish or product-prefixed forms (speech_to_text, text_to_speech, tapra_status), but the set stays predictable and scannable.
16 tools is slightly above the ideal band but justified by the breadth of the domain (transcription, diarization, TTS, voiceover, translation, audio editing, diagnostics). No tool looks like pure filler, though diarize_audio comes closest since speech_to_text already returns speaker labels.
The surface covers a full media-localization lifecycle: status/balance, voice listing, STT, subtitles, speaker naming, diarization, TTS, voiceover, translation (text and subtitle files), script conversion, transcript search, playback, and ffmpeg editing. Minor gaps remain around discovering/managing previously generated output files or long-running jobs, which agents must work around by tracking paths themselves.