VideoToURL mcp
Turn any videos into shareable url links reliably, free, no watermark.
ホスト型 MCP サーバー
npx add-mcp 'https://videotourl.net/api/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
MCP server for AI agents
VideoToURL runs a remote Model Context Protocol server. Connect an agent to it and the agent can turn a video file into a share link, list and inspect your videos, read their analytics, password-protect them, set an expiry, and delete them. It is included with every account, the free plan too. You connect by signing in. On Business you can also use the same API keys as the REST API.
Connect in one click
Pick your AI app, add VideoToURL, sign in with your VideoToURL account, and start asking.
You need a free VideoToURL account. Sign in or create one.
Add VideoToURL to ChatGPT
Add a custom connector named VideoToURL with this server URL. ChatGPT then sends you to VideoToURL to sign in and approve.
Server URL
Start using it in ChatGPT
Ask ChatGPT to work with your videos. For example:
Use VideoToURL to list my five most recent videos with their share links.
Connection details
- URL: https://videotourl.net/api/mcp
- Transport: Streamable HTTP (stateless)
- Auth: OAuth sign-in (the app sends you to VideoToURL to approve it), or the header
Authorization: Bearer vtu_…with an API key from your dashboard (Business plan)
Setup
ChatGPT
- In the left sidebar, open Plugins, then choose Add in the top-right corner and Add custom MCP server. You can also get there from Settings: choose Browse directory in the top-right corner, then Add → Add custom MCP server.

- Name it VideoToURL. Under Connection, keep Server URL and enter https://videotourl.net/api/mcp. Leave Authentication on OAuth and the advanced OAuth settings as they are. Tick I understand and want to continue, then choose Create as a plugin.

- ChatGPT sends you to VideoToURL. Sign in and approve.
Claude (claude.ai and the desktop app)
- Open Settings → Customize. On the Connectors tab, choose Add → Add custom connector.

- Name it VideoToURL, enter https://videotourl.net/api/mcp, and choose Continue.

- Keep the options Claude detects: Sign in now under Authentication and Register automatically under OAuth client. Don't add any request headers.

- Finish adding the connector. Claude sends you to VideoToURL. Sign in and approve.
Uploading a file from Claude
Claude can list, inspect, protect and delete your videos, and import a video that is already online, with no extra setup. To upload a file from the chat itself, such as a video you attach or one Claude makes, Claude sends it from its sandbox, which can only reach websites you allow. Allow our storage host once:
- Open Settings → Capabilities. Under Create and edit files, which must be on, turn on Use the internet while making files.

- Next to Allowed websites, choose Manage.

- Leave Which sites to allow on Standard download sites only. Under Add a website, enter 0a7a6f48913783de2609e1c1ca53dbd9.r2.cloudflarestorage.com and choose Add. Only this one host is needed, not a wildcard.

- Start a new chat, so the sandbox picks up the setting.
ChatGPT needs none of this: it hands the file to VideoToURL directly. If the setting doesn't seem to take effect in Claude, ask it to use a direct link to the video instead.
Grok (grok.com)
- At the bottom of the left sidebar, open Plugins, then choose New Connector in the top-right corner.

- Choose Custom. Name it VideoToURL, enter https://videotourl.net/api/mcp as the Server URL, and choose Add Connector.

- Grok sends you to VideoToURL. Sign in and approve.
Connected apps are listed on your dashboard, where you can disconnect any of them. Menu names in ChatGPT, Claude and Grok change from time to time. Look for “connectors” or “MCP” if they have moved.
Claude Code
claude mcp add --transport http videotourl https://videotourl.net/api/mcp
Then run /mcp in Claude Code to sign in. On Business, to use an API key instead, add --header "Authorization: Bearer vtu_your_key_here".
Cursor, VS Code, Windsurf and other clients with a JSON config
Clients that support OAuth only need the URL, and they ask you to sign in. Otherwise, on Business, pass an API key:
{
"mcpServers": {
"videotourl": {
"url": "https://videotourl.net/api/mcp",
"headers": { "Authorization": "Bearer vtu_your_key_here" }
}
}
}
Claude API (MCP connector)
client.beta.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
betas=["mcp-client-2025-11-20"],
mcp_servers=[{
"type": "url",
"url": "https://videotourl.net/api/mcp",
"name": "videotourl",
"authorization_token": "vtu_your_key_here",
}],
tools=[{"type": "mcp_toolset", "mcp_server_name": "videotourl"}],
messages=[{"role": "user", "content": "List my five most-viewed videos"}],
)
OpenAI Responses API (ChatGPT models)
client.responses.create(
model="gpt-5",
tools=[{
"type": "mcp",
"server_label": "videotourl",
"server_url": "https://videotourl.net/api/mcp",
"headers": {"Authorization": "Bearer vtu_your_key_here"},
"require_approval": "always",
}],
input="Password-protect my latest video with the password s3cret",
)
xAI API (Grok) and others
Any client that supports remote MCP servers with a custom header works the same way. Give it the URL above and the Authorization header.
How an upload works
There are three ways, and the agent picks the one that suits it.
- A file in the chat (
upload_video_file): in ChatGPT, attach the video and ask for a link. ChatGPT gives VideoToURL a temporary download link for the file, and we fetch it ourselves. This is needed because ChatGPT's sandbox has no internet access of its own. - A video already online (
upload_video_from_url): give the agent a direct download URL, not a page that plays the video, and we fetch it. - From the agent's own machine (
create_upload, thencomplete_upload): the agent sends the bytes straight to storage with an HTTP PUT. This needs network access, such as a terminal withcurlin Claude Code or Cursor. It is also the path for large files.
When we fetch a file, the download has to finish in about 50 seconds. That is plenty for a typical clip, but a very large file may need the third path.
Tools
What an agent can do once it is connected. It picks the tools itself; you just ask in plain words.
get_account
Shows your plan, the storage you have used and the size limit per file.
get_video
Shows one video: its watch page, embed and direct links, size, views and expiry.
get_video_stats
Shows a video's views per day, plus the top referring sites and countries on Business.
upload_video_file
Uploads a video file from the chat and returns its link in one step. This is how ChatGPT uploads.
upload_video_from_url
Uploads a video from a direct download link and returns its share link.
create_upload
Starts an upload that the agent sends from its own machine, for example with curl.
sign_upload_parts
Signs the parts of a large upload, so it can resume after an interruption.
complete_upload
Finishes an upload started with create_upload and returns the links.
update_video
Sets or removes a password, or changes when a video expires.
delete_video destructive
Deletes a video permanently. Its links stop working immediately.