Bitmovin Observability MCP Server

The Bitmovin Observability MCP Server enables MCP-compatible AI tools such as Claude and ChatGPT to access your data. This provides natural-language exploration of video playback metrics, license usage, and viewer experience insights — all through simple questions.

The MCP server also supports rendering interactive charts and visualizations of your data directly alongside your queries.

🧭 What It Does

The MCP server connects your Bitmovin account to your AI assistant.
Once configured, you can ask the assistant questions like:

“What was the 95th percentile video startup time for mobile users in Germany yesterday?”
“Compare rebuffer percentage by CDN provider across the top 5 countries over the last 7 days.”
“Show me a plot of error rate over the last 7 days.”
“Which browsers have the highest error rate over the past month?”
“Show me a plot of the video startup time for yesterday.”
“Give me a combined breakdown of total hours watched by device type and operating system for the last week.”
“Based on data from last week, what do I need to improve this week?”
“Break down plays by browser over the last 30 days.”
“Analyse impression abc123 — walk me through what happened during that session.”
“What are the most frequent error codes this week, and what messages are associated with them?”
“Which player versions have the highest error rates?”

Behind the scenes, these questions are translated into precise API calls (such as query, queryGroupBy, and analyzeImpression), returning structured analytics data that the assistant can interpret or visualize for you.

The MCP server is hosted on Alpic.

⚙️ Setup Instructions

The instructions below describe setup with Claude and ChatGPT, however, the MCP server is compatible with any LLM that supports MCP servers. Please note: if using Claude, a Claude Pro subscription is currently required to use MCP servers.

🤖 Setup in ChatGPT

Bitmovin is available as an official app in the ChatGPT App Directory, covering all Bitmovin products including the Observability MCP Server — connect directly without any manual configuration.

Go to chatgpt.com/apps
Search for "Bitmovin" in the search bar
Click Connect
Sign in with your Bitmovin account and you can start chatting immediately.

🖥️ Setup in Claude Desktop

To make this server available inside Claude Desktop:

Open
~/Library/Application Support/Claude/claude_desktop_config.json

Add the following entry:

{
  "mcpServers": {
    "analytics-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://analytics.mcp.bitmovin.com/",
        "--header",
        "x-api-key: <API_KEY>",
        "--header", 
        "x-tenant-org-id: <TENANT_ORG_ID>" -- optional only if tenant access is needed
      ],
      "env": {}
    }
  }
}

Note: Claude Desktop requires Node v20 or later to use MCP Servers. You may experience errors if trying to use older Node versions with MCP Servers in Claude Desktop.

🛠️ Setup in Claude CLI

Use this command (eg. in Mac Terminal):

claude mcp add -s user analytics-mcp[--org-<org-name>] -- npx mcp-remote https://analytics.mcp.bitmovin.com/ --header "x-api-key: <API_KEY>" --header "x-tenant-org-id: <TENANT_ORG_ID>"

Verify the setup by running this command:

claude mcp list

📊 Usage Limits

MCP server usage contributes towards your overall usage of our API and rate limits apply. If you're planning to make a high volume of requests (eg. >100 per minute), or you run into rate limiting, please contact us.