Bitmovin MCP Server

Ask your AI assistant about your Bitmovin data.

What is the Bitmovin MCP Server?

The Bitmovin MCP Server connects AI tools like Claude and ChatGPT to your Bitmovin account. Once it's connected, you can ask about your playback quality, check your encodings, play a stream or open a support ticket, all from the chat you already use.

It's built on the Model Context Protocol (MCP), an open standard that lets AI tools work with other services.

What you can do with it 🧰

AreaWhat you can askDetails
ObservabilityAnalyze your playback: startup time, rebuffering, errors, plays and ad performance, broken down by country, device, browser, CDN and moreObservability MCP Server
EncodingFind and check your VOD and live encodings, see what was encoded and where it was delivered, check live channel health, review your usage and look up error codesEncoding tools
PlayerPlay a stream with a real Bitmovin Player, right inside the chatPlayer tools
Stream Lab Create test streams, run automated playback tests and read the resultsStream Lab MCP Server
SupportLook up your support tickets or open a new one—
DocumentationGet answers from the Bitmovin docs and find SDK examplesDocumentation tools

Connect your AI tool 🔌

Pick the tool you use. You sign in with your Bitmovin account, so there are no API keys to manage.

Claude

  1. In Claude, open Customize → Connectors.
  2. Search for Bitmovin.
  3. Click Connect and sign in with your Bitmovin account.

Or go straight to Bitmovin in the Claude directory.

ChatGPT

  1. In ChatGPT, open chatgpt.com/plugins.
  2. Search for Bitmovin.
  3. Click Connect and sign in with your Bitmovin account.

Or go straight to Bitmovin in the ChatGPT plugin directory.


Command line (Claude Code and similar)

`claude mcp add bitmovin --transport http `[`https://mcp.bitmovin.com`](https://mcp.bitmovin.com)

Run /mcp inside Claude Code to sign in, then claude mcp list to check it's connected.

To use an API key instead of signing in:

`claude mcp add bitmovin --transport http `[`https://mcp.bitmovin.com`](https://mcp.bitmovin.com)` `<br />`--header "Authorization: Bearer $BITMOVIN_API_KEY"`

Desktop config file (Claude Desktop, Cursor, Windsurf)

These apps start MCP servers from a config file, so you connect through mcp-remote. For Claude Desktop, open:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

For Cursor, Windsurf and other apps, check their MCP documentation for where the file is. Then add:

{
  "mcpServers": {
    "bitmovin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bitmovin.com"]
    }
  }
}

Fully quit and reopen the app. The first time you use Bitmovin, a browser window opens so you can sign in.

To use an API key instead of signing in:

{
  "mcpServers": {
    "bitmovin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bitmovin.com",
        "--header",
        "Authorization:${BITMOVIN_AUTH}"
      ],
      "env": {
        "BITMOVIN_AUTH": "Bearer YOUR_BITMOVIN_API_KEY"
      }
    }
  }
}

🚧 Leave no space after Authorization:

Claude Desktop on Windows and Cursor don't handle spaces inside args correctly. Putting the key in env, as above, avoids the problem.

Custom connector (Claude organization settings)

If you'd rather not use the Claude directory, a Claude admin can add Bitmovin as a custom connector for the whole organization. Nobody needs to install anything or share API keys.

  1. In Claude, open Organization settings → Connectors.
  2. Click Add custom connector.
  3. Enter https://mcp.bitmovin.com and save.
  4. Each person clicks Connect and signs in with their own Bitmovin account.

This option only supports signing in, not API keys. If you need to work with a sub-organization, use the command line or the config file instead.


Try these prompts 👩‍💻


Once Bitmovin is connected, copy any of these into your AI tool. Swap in your own details where you see square brackets.

Start here 🚀

  • "Based on last week's data, what should I improve this week?"
  • "Show me a plot of my error rate over the last 7 days"
  • "Check my encodings"


Observability (Playback quality) 📊

  • "Compare video startup time and rebuffer percentage by operating system over the last 7 days"
  • "Show me startup time across all countries on a world map"
  • "What was the 95th percentile video startup time for mobile users in Germany yesterday?"
  • "Compare rebuffer percentage by CDN provider across my top 5 countries over the last 7 days"
  • "Which browsers had the highest error rate over the past month?"
  • "What were the most frequent error codes this week, and what messages go with them?"
  • "Which player versions have the highest error rates?"
  • "Break down total hours watched by device type and operating system for last week"


Ads (Observability) 📢

  • "How many ad impressions were recorded this week, and how many actually started playing?"
  • "Show me the ad completion funnel for last week, from first quartile to completed"
  • "What were the click-through rate and skip rate for ads last week?"


Encoding ⚙️

  • "“List my recent encoding jobs and show me which ones failed”
  • “Why did encoding [encoding ID] fail, and what does the error code mean?”
  • “Show me the rendition ladder of my latest encoding and where the output was delivered”
  • “Is my live encoding [encoding ID] healthy right now? Show me any disconnects in the last hour”
  • “How many encoding minutes did we use each day last month?”
  • “List my encoding templates”


Player ▶️


Support 🎫

  • "List my recent support tickets"
  • "Show me ticket [ticket ID] and its comments"
  • "Create a support ticket for [describe the issue]"


Documentation 📖

  • "How do I configure Widevine DRM on the Bitmovin Web Player? Link me to the relevant docs."
  • "Show me a Java example that creates a VOD encoding with HLS and DASH outputs."
  • "What are all the supported codecs for live encoding today?"
  • "Find an iOS SDK sample that uses offline playback."
  • "Explain the difference between Per-Title and 3-Pass encoding, with a link to the docs."

Security and your data 🔒

  • You sign in with your Bitmovin account, and the MCP Server only sees data your account can already access.
  • The MCP Server doesn't store your data. It checks your sign-in, passes each request to the right Bitmovin service and returns the result.
  • The MCP Server doesn't include an AI model. Your AI tool does the reasoning, so your questions and the answers are handled by that tool under its own data policies.


Related 📚

  • AI at Bitmovin: the full technical reference for the MCP Server, the Bitmovin skill and the CLI
  • Bitmovin Assistant: an AI assistant built into the Bitmovin Dashboard, with nothing to set up

Did this page help you?