VideoToURL mcp

Transformez n’importe quelle vidéo en lien URL partageable, de manière fiable, gratuitement et sans filigrane.

Serveur MCP hébergé

npx add-mcp 'https://videotourl.net/api/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

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.

Try it in ChatGPT

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

  1. 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.ChatGPT's Plugins page, with Plugins selected in the left sidebar and the Add menu open at Add custom MCP server.
  2. 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.The Add custom MCP server form, with the name VideoToURL, the server URL https://videotourl.net/api/mcp, OAuth authentication, and the confirmation box ticked.
  3. ChatGPT sends you to VideoToURL. Sign in and approve.

Claude (claude.ai and the desktop app)

  1. Open Settings → Customize. On the Connectors tab, choose Add → Add custom connector.Claude's Settings, with Customize selected, the Connectors tab open, and the Add menu showing Add custom connector.
  2. Name it VideoToURL, enter https://videotourl.net/api/mcp, and choose Continue.The Add custom connector dialog, with the name VideoToURL and the URL https://videotourl.net/api/mcp filled in.
  3. Keep the options Claude detects: Sign in now under Authentication and Register automatically under OAuth client. Don't add any request headers.The connector's authentication options, with Sign in now and Register automatically selected, both marked Detected.
  4. 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:

  1. Open Settings → Capabilities. Under Create and edit files, which must be on, turn on Use the internet while making files.Claude's Capabilities settings, with Create and edit files on and the Use the internet while making files switch highlighted.
  2. Next to Allowed websites, choose Manage.Use the internet while making files switched on, with the Manage button next to Allowed websites.
  3. 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.The Allowed websites page, with the storage host typed into Add a website, next to the Add button.
  4. 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)

  1. At the bottom of the left sidebar, open Plugins, then choose New Connector in the top-right corner.Grok's Connectors panel, opened from Plugins at the bottom of the sidebar, with the New Connector button in the top-right corner.
  2. Choose Custom. Name it VideoToURL, enter https://videotourl.net/api/mcp as the Server URL, and choose Add Connector.Grok's New Connector dialog with Custom highlighted, and the Custom Connector form with a name and the server URL https://videotourl.net/api/mcp filled in.
  3. 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, then complete_upload): the agent sends the bytes straight to storage with an HTTP PUT. This needs network access, such as a terminal with curl in 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.