Yes, Whipscribe is free to use.

How do I install Whipscribe?

Whipscribe is a local plugin. Install it using PyPI package: whipscribe-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Whipscribe safe to use?

Whipscribe was flagged by MCP Marketplace's security scan, scoring 4.8/10 (high risk). It has 5 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Whipscribe need?

Whipscribe requires the following credentials or environment variables: WHIPSCRIBE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Whipscribe?

Whipscribe uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Whipscribe MCP Server

by Neugence

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8

Use Caution4.8High Risk

This is a well-structured MCP server for the Whipscribe transcription API with proper authentication handling, no malicious patterns, and appropriate input validation. The server correctly stores API keys via environment variables, implements retry logic with sensible backoff, and avoids logging sensitive data. Minor code quality issues (broad exception handling, unvalidated environment variable parsing) and telemetry implementation details are present but do not create security vulnerabilities. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

4 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

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

Environment variable: WHIPSCRIBE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-neugence-whipscribe-mcp": {
      "env": {
        "WHIPSCRIBE_API_KEY": "your-whipscribe-api-key-here"
      },
      "args": [
        "whipscribe-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

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

Tool	Description
`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

Variable	Required	Default	Purpose
`WHIPSCRIBE_API_KEY`	No	—	API key (links jobs to your account and its credits; without it, every recording still gets a free preview)
`WHIPSCRIBE_API_BASE`	No	`https://whipscribe.com/api/v1`	Override API base URL (e.g. for staging)
`WHIPSCRIBE_MCP_TELEMETRY`	No	`1`	Set to `0` to disable anonymous usage telemetry
`WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDS`	No	`600`	Max seconds `transcribe_url` / `transcribe_file` waits before returning the job_id with a non-terminal status
`WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDS`	No	`3`	Seconds 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

Contact

Website: whipscribe.com
Email: contact@neugence.ai
Issues: github.com/neugence/whipscribe-mcp/issues

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.