Connect the VideoUpscaler video MCP server to Claude Code, Cursor or VS Code and upscale videos to 1080p, 2K or 4K by asking your AI assistant.

VideoUpscaler runs a remote video MCP server built on the Model Context Protocol. Connect it to your AI assistant and ask things like "upscale this video to 4K" — the assistant calls the same API described in these docs and uses your credits.

Server URL: https://videoupscaler.co/api/mcp (Streamable HTTP)

Paid accounts; balance for everyone

Like the API, the MCP server is available to accounts that have bought credits or subscribed. Clients connect by signing in to your VideoUpscaler account, or with an API key. Any account can sign in and check its balance with get_account; the other tools need a paid account.

Connect the MCP server to your client

Most clients connect to the video MCP server by signing in: you add the server URL, a browser window opens, and you sign in to VideoUpscaler and click Allow. Clients that can't sign in use an API key instead: create one in Settings → API Keys and keep it in an environment variable such as VIDEOUPSCALER_API_KEY. Don't paste the key into a config file you commit.

In claude.ai or the Claude desktop app, open Settings → Connectors, click Add custom connector and enter https://videoupscaler.co/api/mcp. Click Connect, then sign in and allow access.

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope user

Run /mcp in Claude Code, select videoupscaler and choose Authenticate to sign in in your browser. --scope user makes the server available in all your projects.

To use an API key instead, add --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" to the command.

Cursor connects with an API key. Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "videoupscaler": {
      "url": "https://videoupscaler.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code asks you to sign in the first time the server starts:

{
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp"
    }
  }
}

Any client that supports remote MCP servers over Streamable HTTP works. Enter the server URL above: clients that support MCP authorization sign in automatically. Other clients send the header Authorization: Bearer <your API key>.

MCP video tools

Tool	What it does
`upscale_video`	Starts an upscale of a public `video_url` to `1080p`, `2k` or `4k` and charges credits. Requires an `idempotency_key`.
`get_task`	Returns a task. With `wait_seconds` (up to 45) it waits for the task to finish first.
`list_tasks`	Lists your recent tasks, including ones started on the website.
`get_account`	Your credit balance and the price per second for each resolution.
`create_upload`	Returns a signed URL for uploading a local file (up to 100MB) that has no public URL.

The tools behave exactly like the matching API endpoints: see Create an upscale, Tasks, Credits & pricing and Upload a file. Tasks started through MCP cost the same credits.

Every upscale_video call needs an idempotency_key. If a call times out, the assistant should check list_tasks and retry with the same key, so the video is never charged twice.

Example prompts

"How many VideoUpscaler credits do I have left?"
"Upscale https://example.com/clip.mp4 to 4K and give me the link when it's done."
"Upscale ./intro.mp4 to 2K." (clients that can run commands upload the file with create_upload first)

Troubleshooting

Problem	Fix
The client shows `401` or asks you to sign in	Sign in again from the client. With an API key, check the `Authorization` header and that the key still exists in Settings.
The sign-in page says the authorization link is invalid	The link expires after 10 minutes. Start the connection again from your client.
Tools return `paid_plan_required`	The account has never bought credits. Buy any credit pack.
Tools return `insufficient_credits`	Top up your balance on the pricing page.
`upscale_video` times out	Large remote videos take a while to download. Ask the assistant to check `list_tasks`; the task usually exists.

Video MCP server

Connect the MCP server to your client

MCP video tools

Example prompts

Troubleshooting

On this page