Bitmovin Observability MCP Server

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

🧭 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 average video startup time yesterday for Germany?”
“Based on data from the last week, what do I need to improve this week?”
“Show me a summary of impression abc123.”
“Which of our analytics licenses are most used in production?”
“Compare average bitrate by country over the last 7 days.”

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.

⚙️ Setup Instructions

The instructions below describe setup with Claude, however, the MCP server is compatible with other LLMs which support MCP servers. Please note: if using Claude, a Claude Pro subscription is currently required to use MCP servers.

🖥️ 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