Whipscribe Mcp

io.github.neugencePublished by GitHub account neugencev0.1.5Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Sends audio or video from a URL or local file to the WhipScribe cloud API for transcription and returns the transcript in several formats.

What you can do
  • Transcribe audio or video from a URL (YouTube, podcast feeds, direct file links) or a local file, with optional language, speaker diarization and word timestamps
  • Check the progress of a running transcription job
  • Fetch the finished transcript as txt, json, srt, vtt or docx
  • Browse recent jobs from a local cache
When to use it
Useful when you want an assistant to turn a podcast, video link or local recording into text, subtitles or a document without leaving the chat. It is a beta service, so it suits experiments and personal workflows rather than production pipelines.
Requirements
Runs locally as a Python package (Python 3.10+) via uvx, pipx or pip, configured as a stdio server in the client. Network access to the WhipScribe API is required. An API key in WHIPSCRIBE_API_KEY is optional; without it each recording still gets a free preview. Optional variables set the API base URL, telemetry, and polling timeout and interval.
Before you install
Audio, video and URLs are sent to the WhipScribe cloud service for processing. The service is in beta: endpoints, quotas and credits can change, jobs may fail or stall, and it is not meant for cases where transcription failure has legal, safety or financial consequences. Anonymous telemetry is on by default and can be disabled with WHIPSCRIBE_MCP_TELEMETRY=0. Paid quota needs credit packs or a subscription.

Installation

In SourceWeft

  1. Open Whipscribe Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
uvx whipscribe-mcp

Alternatives:

bash
pipx install whipscribe-mcppip install whipscribe-mcp

Requires Python 3.10+.

Claude Desktop

Add to claude_desktop_config.json:

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

Optional: set WHIPSCRIBE_API_KEY in env to unlock paid quota.

json
{  "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:

json
{  "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:

json
{  "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

Source: README.md at commit 9761718

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.5LatestOct 5, 2026
  2. v0.1.4Sep 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts