SpeechWeave MCP server

@speechweave/mcp

Official Model Context Protocol server for SpeechWeave. Use to transcribe local files and URLs from Cursor, Claude Desktop, Claude Code, Windsurf, and other MCP clients.

SpeechWeave handles short clips and long-form audio without client-side chunking. This MCP server exposes both wait-first tools (get a transcript in one turn) and async create + poll tools (start a job, then check status).

Docs: speechweave.com/docs/mcp · API reference

Install / run

Requires Node.js 18+ and a SpeechWeave API key (sklive…).

export SPEECHWEAVE_API_KEY="sk_live_..."
npx -y @speechweave/mcp

Cursor / Claude Desktop

Add to your MCP config (e.g. .cursor/mcp.json, claudedesktopconfig.json):

{
	"mcpServers": {
		"speechweave": {
			"command": "npx",
			"args": ["-y", "@speechweave/mcp"],
			"env": {
				"SPEECHWEAVE_API_KEY": "sk_live_..."
			}
		}
	}
}

Tools

Never pass raw audio bytes over MCP. Use absolute file paths (local clients) or HTTPS URLs.

Configuration & Arguments

All transcription and job-start tools accept the following optional arguments:

• model: Choose core (default) or max.
• service_mode: Choose standard (default) or deferred for the background queue. synchronous is accepted as an alias for standard.
• language: Optional ISO language code to force language detection.
• task: Choose transcribe (default) or translate to produce an English translation instead; language is ignored when translating.
• prompt: Optional custom vocabulary hint (proper nouns, acronyms, product names) for the first ~30s of audio.

Formatted transcripts: transcribefile, transcribeurl, and getjobstatus also accept an optional responseformat (text, srt, vtt, or verbosejson) to return the transcript in that shape instead of the default plain text.

Timeout behavior: Wait-first tools accept an optional timeoutms. If the transcription exceeds the timeout, the tool gracefully returns a jobid and instructs the client to switch to getjobstatus polling.

Account limits and docs

• get_limits: Returns GET /v1/limits for the calling key, with MB equivalents. Use before uploading large local files.
• fetchdoc: Returns public documentation. Slug list shows the catalog. Bundled pages include quickstart, mcp, models, billing, and dataretention. Slug api fetches a live OpenAPI overview; api/ returns one endpoint (e.g. api/getv1limits).

Example Prompts

After adding the server and restarting your client, try asking your AI assistant:

Short clip (wait-first)

"Use SpeechWeave to transcribe /Users/me/recordings/standup.mp3 and summarize action items."

The assistant will call transcribefile with the absolute path and summarize the returned transcript.*

Shortened. The full README is on GitHub.