Skip to main content
Glama

SaveDock MCP: free video downloader MCP server for AI agents

SaveDock MCP lets AI agents and MCP clients (Claude, Cursor, VS Code, Windsurf and any client with remote MCP support) download videos and audio by calling tools. Give your agent a link from YouTube, Instagram, TikTok, Facebook, X (Twitter) or Pinterest and it can read the video's details, then save it as MP4 video or MP3 audio.

It is the MCP server behind SaveDock, a free online video downloader. No account, no API key, no sign-up.

Quick start: connect to the hosted server

You do not need to install or run anything. Add the URL to your MCP client.

Claude Code:

claude mcp add --transport http savedock https://mcp.savedock.pro/mcp

Any client that reads a JSON config:

{
  "mcpServers": {
    "savedock": { "url": "https://mcp.savedock.pro/mcp" }
  }
}

Exact syntax differs between clients, so check your client's remote MCP documentation. After connecting, just ask: "Download this YouTube video as MP3: https://..."

Free use is limited per IP address (10 downloads per hour). Downloaded files are temporary and are deleted automatically after a few hours.

Related MCP server: TubePull – AI YouTube Downloader

Tools

Tool

What it does

get_video_info(url)

Returns title, uploader, duration and the qualities available. Read-only.

download_video(url, quality="best", audio_only=false, wait_seconds=...)

Starts a download and waits for it. Returns a temporary download_url, or a job id if it is still running. Use audio_only=true for MP3.

get_download_status(job_id, wait_seconds=...)

Checks a running job.

cancel_download(job_id)

Stops a queued or running job.

Resources: videodl://platforms (supported sites and limits) and videodl://quality-options (what quality accepts).

Results include readable text plus structured content. Errors come back with isError: true and a machine-readable code, message, retryable and retry_after, so an agent can decide whether to retry. The server returns a download link; file bytes are never placed into the conversation.

Supported platforms

YouTube, Instagram, TikTok, Facebook, X (Twitter) and Pinterest. Availability depends on what each site allows, and some videos (private, age-restricted or region-locked) cannot be downloaded.

Install and run it yourself

This package is a thin Model Context Protocol adapter over the SaveDock REST API. It has no yt-dlp, no database and no business logic of its own, so it needs an API to talk to (VIDEODL_API_URL).

git clone https://github.com/QamarAftab575/savedock-mcp.git
cd savedock-mcp
pip install .            # or: pip install -r requirements.txt

# Local, one user (stdio):
VIDEODL_API_URL=https://your-api.example.com python -m mcp_server

# Remote, many callers (Streamable HTTP, endpoint /mcp):
VIDEODL_API_URL=https://your-api.example.com \
MCP_ALLOWED_HOSTS=mcp.example.com \
python -m mcp_server --transport streamable-http --host 0.0.0.0 --port 8001

Or with Docker:

docker build -t savedock-mcp .
docker run -p 8001:8001 -e VIDEODL_API_URL=https://your-api.example.com savedock-mcp

Settings

Variable

Meaning

VIDEODL_API_URL

Where /api/v1/ lives (default http://127.0.0.1:8000).

VIDEODL_API_KEY

Optional key for higher limits, used on stdio only and ignored over HTTP.

MCP_TRUST_PROXY

Set true only when a reverse proxy you control sits in front, so per-user limits use the forwarded address.

MCP_HOST, MCP_PORT

Bind address (default 127.0.0.1:8001).

MCP_ALLOWED_HOSTS

Comma list of public host names; turns on DNS-rebinding protection. Set it in production.

MCP_ALLOWED_ORIGINS

Browser origins allowed to call the server.

MCP_WAIT_SECONDS, MCP_MAX_WAIT_SECONDS, MCP_POLL_SECONDS

Wait defaults, cap and poll interval.

Tests

python -m unittest discover -s mcp_server/tests -t .

The tests use a mocked REST service and a real in-memory MCP client.

Responsible use

Only download content you own, that is in the public domain, or that you have permission to save. You are responsible for following the terms of the platforms you use and the copyright law that applies to you.

License

MIT. See LICENSE.

Available Tools

4 tools
cancel_downloadA
DestructiveIdempotent

Stop a queued or running download and discard its partial file. Finished downloads are unaffected.

Inputs: job_id (required).

download_videoA

Download a video or audio track and return a temporary download link. Finishes within wait_seconds for most videos; otherwise returns a job id to pass to get_download_status.

Inputs: url (required), quality, audio_only, wait_seconds.

get_download_statusA
Read-onlyIdempotent

Check a download. When status is "done" the result contains the temporary download_url.

Inputs: job_id (required), wait_seconds.

get_video_infoA
Read-onlyIdempotent

Look up a video's title, duration, uploader and the qualities it can be downloaded in, without downloading it.

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool covers a distinct stage of the video download lifecycle: metadata lookup, download initiation, status polling, and cancellation. There is no overlap between tools, and the download/status pair is explicitly linked by the job id handoff.

    Naming Consistency5/5

    All names use snake_case with a clear verb_noun or verb_object pattern: get_video_info, download_video, get_download_status, cancel_download. The convention is predictable and easy for an agent to map to actions.

    Tool Count5/5

    Four tools is well-scoped for a focused video download service, and each tool earns its place by covering a necessary operation. There is no redundant or filler tool.

    Completeness4/5

    The core lifecycle is covered: inspect, download, check status, and cancel. Minor gaps exist, such as listing past downloads or deleting temporary files, but these are not essential for the stated purpose and agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to extract TikTok video and soundtrack media, metadata, covers, and manifests from public URLs or IDs through verified downloads and schema access via MCP tools.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Turns TikTok, Instagram, X/Twitter and Facebook post URLs into video download links plus metadata (title, author, duration, thumbnail), so AI agents can fetch social videos in one tool call.
      2
      64 npm
      MIT