spimov-mcp

MCP server for Spimov — dub videos via Claude Desktop / Claude Code / any MCP client.

Two transports:

• stdio — runs locally, spawned by your MCP client, authenticated with `SPIMOV_API_KEY` env var. Supports local file upload (`create_dub`).
• HTTP — long-lived server (we host at `mcp.spimov.com`), authenticated per-request with `Authorization: Bearer spk_live_...` (or `?api_key=`). Exposes both Streamable HTTP (`/mcp`, current spec) and legacy SSE (`/sse`). URL-only — no local file upload.

Both transports are thin wrappers over the public REST API at `https://spimov.com/api/v1`. The same API key, the same daily request quota.

1. Get an API key

Sign in at https://spimov.com → Settings → API keys → Create new key. Copy the `spk_live_...` token shown once.

2a. Use via stdio (Claude Desktop)

Install:

pip install spimov-mcp

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

{
  "mcpServers": {
    "spimov": {
      "command": "spimov-mcp",
      "env": {
        "SPIMOV_API_KEY": "spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. The "spimov" MCP server should appear; ask Claude to "dub /Users/me/Movies/clip.mp4 into Turkish using Spimov".

2b. Use via HTTP (Claude Code / Claude web / other clients)

Self-hosted: `MCP_PORT=8001 spimov-mcp-http`. Hosted endpoints:

• Streamable HTTP (recommended): `https://mcp.spimov.com/mcp`
• Legacy SSE: `https://mcp.spimov.com/sse`

Claude Code / config-file clients (header auth):

{
  "mcpServers": {
    "spimov": {
      "url": "https://mcp.spimov.com/mcp",
      "headers": {
        "Authorization": "Bearer spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude web (claude.ai → Settings → Connectors → *Add custom connector*): the

UI only takes a URL, so put the key in the query string:

https://mcp.spimov.com/mcp?api_key=spk_live_xxxxxxxxxxxxxxxxxxxxxxxx

> The key travels in the URL (stored in your connector config). Treat it like a

> password and rotate it from Settings → API keys if it leaks. Local file

> tools (`create_dub`, `download_video`) are unavailable here — use `dub_youtube`

> to dub, and `get_download_url` to get a clickable browser download link for the

> finished MP4.

3. Tools

Dubbing tools (`create_dub`, `dub_youtube`) accept an optional(quality voice, default), `chatterbox` (emotion voice), or `elevenlabs` (paid).

4. Override the API base (dev)

SPIMOV_API_BASE=http://localhost:8000/api/v1 spimov-mcp