Skip to main content
Glama
Tapra MCP server
by tapra-ai

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TAPRA_API_KEYYesYour Tapra API key (starts with tapra_sk_live_…). Required.
TAPRA_API_URLNoForce an API origin, e.g. http://127.0.0.1:8787 for a local model host. Default: read from tapra.tn.
TAPRA_SITE_URLNoWebsite serving the price list, balance, and the current API address. Default: https://tapra.tn.
TAPRA_BASE_PATHNoInput files must be inside this folder; relative paths resolve here. Default: home folder.
TAPRA_OUTPUT_DIRNoWhere generated files go; outputs can't be written anywhere else. Default: ~/Tapra.
TAPRA_FFMPEG_PATHNoPath to ffmpeg if it is not on PATH. Default: ffmpeg.
TAPRA_AUDIO_PLAYERNoProgram play_audio runs as <player> <file>. Default: ffplay, then the system player.
TAPRA_MAX_COST_TNDNoRefuse any single call estimated above this amount. Default: none.
TAPRA_MCP_OUTPUT_MODENoOutput mode: files saves results; resources returns them inline only (nothing saved); both does both. Default: files.
TAPRA_TIMEOUT_SECONDSNoPer-request timeout. Default: 600.
TAPRA_MCP_MAX_INLINE_MBNoLargest 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

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 16 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues