Skip to main content
Glama

Transcreva is an AI audio and video transcription service built for Brazilian Portuguese (pt-BR), with support for 12+ languages, speaker diarization (identificação de falantes), and instant export to TXT, DOCX, SRT, VTT, and JSON.

This repository provides:

  1. Remote & Local MCP Servers for Claude Desktop, Claude Code, Cursor, Windsurf, and VS Code

  2. Zero-dependency Node.js CLI & SDK (bin/transcreva.mjs) with automatic multipart upload to R2 for files up to 2 GB / 10 hours

  3. Agent Skill (skills/transcreva/SKILL.md) compatible with npx skills add arkyu2077/transcreva-mcp


1. Install the Agent Skill (skills.sh)

npx skills add arkyu2077/transcreva-mcp

Related MCP server: GhostMinutes MCP

2. MCP Server Setup

First, generate an API key (sk_...) in your account at transcreva.net/conta under Chaves de API e MCP (available on the Ilimitado plan).

Option A: Remote HTTP MCP Server (https://transcreva.net/api/mcp)

Zero local installation required. Works with any MCP client supporting Streamable HTTP:

Claude Code

claude mcp add --transport http transcreva https://transcreva.net/api/mcp \
  --header "Authorization: Bearer $TRANSCREVA_API_KEY" --scope user

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "transcreva": {
      "url": "https://transcreva.net/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TRANSCREVA_API_KEY}"
      }
    }
  }
}

Option B: Local Stdio MCP Server (Supports Local File Uploads up to 2 GB)

Use the local stdio server when you want your AI assistant to directly upload and transcribe local .mp3, .m4a, .wav, .ogg, .opus, .mp4, .mov, or .webm files from your disk:

{
  "mcpServers": {
    "transcreva": {
      "command": "node",
      "args": ["/path/to/transcreva-mcp/bin/transcreva-mcp.mjs"],
      "env": {
        "TRANSCREVA_API_KEY": "sk_..."
      }
    }
  }
}

Available MCP Tools

Tool

Description

transcribe_media

Uploads a local audio/video file or public URL, waits for completion, and returns the formatted transcript (txt, srt, vtt, json, docx) or writes it to outputPath.

get_transcription

Checks the status of a transcription by ID or exports the completed transcript in txt, srt, vtt, json, or docx.

list_transcriptions

Lists or searches your transcription history on Transcreva.

rename_speakers

Updates the transcription title and/or renames identified speaker labels (e.g. S1 → João Silva).

delete_transcription

Permanently deletes a transcription and its underlying media file.

get_account_quota

Returns your current plan (unlimited, pro, plus) and usage metrics.


3. Command-Line Interface (CLI)

export TRANSCREVA_API_KEY="sk_..."

# Transcribe a local file to Portuguese text with timestamps
node bin/transcreva.mjs transcribe ./reuniao.m4a

# Transcribe an interview with speaker identification and export to Word (.docx)
node bin/transcreva.mjs transcribe ./entrevista.mp4 --speakers --format docx --out ./entrevista.docx

# Generate SRT subtitles for a video
node bin/transcreva.mjs transcribe ./aula.mp4 --format srt --out ./aula.srt

# Rename speakers on an existing transcription
node bin/transcreva.mjs rename <id> --title "Ata de Reunião" --speaker S1="Maria" --speaker S2="Pedro"

# List recent transcriptions
node bin/transcreva.mjs list --search "reunião"

License

MIT © SailorFlow LLC (transcreva.net)

Guias Práticos em Português (GitHub Pages)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers