Model Context Protocol (MCP) server for Ssave.cc — extract and download TikTok / Instagram / YouTube / Douyin media (HD video without watermark, MP3 audio) directly to your local disk.

Runs locally via stdio, backed by the Ssave Open API (/open/v1). No registration required on the free tier.

Quick Start

npx @ssavecc/mcp-server

Then add it to your MCP client:

Claude Code

claude mcp add ssave -- npx @ssavecc/mcp-server

Or project-level .mcp.json:

{
  "mcpServers": {
    "ssave": { "command": "npx", "args": ["@ssavecc/mcp-server"] }
  }
}

Cursor

Settings → MCP → Add new MCP server:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Tools

Tool	Description
`extract_media`	Extract metadata and available formats from a TikTok / Instagram / YouTube / Douyin URL. Returns an `ssv_` token (expires in 5–15 min) plus per-format download URLs.
`download_media`	Stream the extracted media to local disk (default `~/Downloads/ssave/`, override with `output_dir`). Returns the absolute path and size.
`get_thumbnail`	Save the media thumbnail to local disk (proxied — never exposes the source CDN link).

Typical flow: extract_media(url) → take the returned id → download_media(id, type: "hd" | "watermark" | "mp3").

Environment Variables

All optional:

Variable	Default	Description
`SSAVE_API_BASE_URL`	`https://api.ssave.cc`	Override for local development (e.g. `http://localhost:8000`).
`SSAVE_API_KEY`	—	Reserved for paid tier (Phase 3): sent as `Authorization: Bearer <key>`.
`SSAVE_OUTPUT_DIR`	`~/Downloads/ssave/`	Default output directory when `output_dir` is not passed.

Rate Limits (free tier)

Shared with the Ssave Open API, per IP per UTC day:

Operation	Limit
`extract`	10 / day
`download`	50 / day

On 429 rate_limited the tool reports the UTC reset time.

Development

npm install
npm run dev        # run server on stdio (connect with MCP Inspector: npx @modelcontextprotocol/inspector)
npm test           # unit tests (mock fetch)
npm run build      # compile to dist/