English Français العربية

io.github.neugence/whipscribe-mcp

Registre officiel Médias et design

Transcribe audio/video files or URLs via the WhipScribe cloud API and fetch the transcript.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package whipscribe-mcp
Claude Code 
claude mcp add whipscribe-mcp -e 'WHIPSCRIBE_API_KEY=<your whipscribe_api_key>' -- uvx whipscribe-mcp==0.1.5
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "whipscribe-mcp": {
            "command": "uvx",
            "args": [
                "whipscribe-mcp==0.1.5"
            ],
            "env": {
                "WHIPSCRIBE_API_KEY": "<your whipscribe_api_key>"
            }
        }
    }
}

Variables d'environnement

  • WHIPSCRIBE_API_KEY secret WhipScribe API key (optional; unlocks paid quota, the anonymous free tier works without it)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. whipscribe-mcp
  2. Install
  3. Claude Desktop
  4. Tools
  5. Environment variables
  6. Privacy
  7. Pricing
  8. License
  9. Contact

whipscribe-mcp

mcp-name: io.github.neugence/whipscribe-mcp

MCP server for Whipscribe — transcribe audio and video from a URL or local file via Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.

⚠️ Beta service
  • whipscribe-mcp and the Whipscribe API are in beta. Endpoints, response shapes, and quotas may change without notice.
  • Jobs can fail, stall, or return partial output. Retry logic is your responsibility.
  • Beta credits can be invalidated without notice — e.g. for infrastructure migration, key compromise, or pricing reset. Beta credits do not convert to cash.
  • We will give 7 days' written notice before any pricing change that affects active keys, and honor unused credits at the old rate for 7 days after the notice.
  • Not suitable for production use cases where transcription failure has legal, safety, or financial consequences.
  • By installing and using this package, you accept the full terms at whipscribe.com/terms.

Install

uvx whipscribe-mcp

Alternatives:

pipx install whipscribe-mcp
pip install whipscribe-mcp

Requires Python 3.10+.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "whipscribe": {
      "command": "uvx",
      "args": ["whipscribe-mcp"]
    }
  }
}

Optional: set WHIPSCRIBE_API_KEY in env to unlock paid quota.

{
  "mcpServers": {
    "whipscribe": {
      "command": "uvx",
      "args": ["whipscribe-mcp"],
      "env": {
        "WHIPSCRIBE_API_KEY": "your-key"
      }
    }
  }
}

Restart Claude Desktop. Type "transcribe this podcast URL: …" and Claude will call the tool.

Tools

ToolDescription
transcribe_url(url, language?, diarize?, word_timestamps?)Transcribe audio/video from any URL (YouTube, podcast feeds, direct file links).
transcribe_file(path, language?, diarize?, word_timestamps?)Transcribe a local audio/video file.
get_job_status(job_id)Check progress of a running job.
get_transcript(job_id, format)Fetch the transcript in txt, json, srt, vtt, or docx.
list_recent_jobs(limit?)Browse your recent jobs (local cache).

All tools return a JSON object of the shape:

{
  "ok": true,
  "job_id": "...",
  "status": "done",
  "transcript_preview": "first 300 chars...",
  "url_to_full": "https://whipscribe.com/view?id=...",
  "duration_sec": 967.3,
  "beta_notice": "..."
}

On failure:

{
  "ok": false,
  "error": {
    "code": "upload_failed",
    "message": "human-readable explanation",
    "retryable": true
  }
}

Environment variables

VariableRequiredDefaultPurpose
WHIPSCRIBE_API_KEYNo—API key (links jobs to your account and its credits; without it, every recording still gets a free preview)
WHIPSCRIBE_API_BASENohttps://whipscribe.com/api/v1Override API base URL (e.g. for staging)
WHIPSCRIBE_MCP_TELEMETRYNo1Set to 0 to disable anonymous usage telemetry
WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDSNo600Max seconds transcribe_url / transcribe_file waits before returning the job_id with a non-terminal status
WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDSNo3Seconds between job-status polls during transcription

Privacy

Opt-in anonymous telemetry (on by default; disable with WHIPSCRIBE_MCP_TELEMETRY=0):

What we collect (metadata only):

  • Anonymous install hash: sha256(machine_id + salt)[:16]
  • Package version, OS, Python version
  • Tool name, duration in milliseconds, error code

What we never collect:

  • URLs you transcribe
  • Local file paths
  • API keys
  • Transcript text
  • Email or any personally identifying information

The anonymization algorithm is in this repo (src/whipscribe_mcp/telemetry.py). Inspect it. If it's not acceptable, turn it off.

Pricing

See whipscribe.com/pricing for current rates. Every recording gets a free preview, with or without an API key; credit packs start at $6 and never expire, and the Workspace plan is $19 a month (fair use 300 hours a month).

License

Apache License 2.0. Copyright 2026 Neugence Technology Pvt. Ltd.

Contact

Questions fréquentes

Qu'est-ce que io.github.neugence/whipscribe-mcp ?

Transcribe audio/video files or URLs via the WhipScribe cloud API and fetch the transcript.

Comment installer io.github.neugence/whipscribe-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add whipscribe-mcp -e 'WHIPSCRIBE_API_KEY=<your whipscribe_api_key>' -- uvx whipscribe-mcp==0.1.5. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.neugence/whipscribe-mcp ?

Oui. Il attend WHIPSCRIBE_API_KEY, à renseigner dans sa configuration.

io.github.neugence/whipscribe-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.neugence/whipscribe-mcp ?

Il est publié par neugence. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.