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 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.”
• “Which browsers have the highest error rate over the past month?”
• “Break down 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?”
• “Analyse impression abc123 — walk me through what happened during that session.”
• “Compare average bitrate between HLS and DASH streams for live content over the last 30 days.”
• “Which ISPs have the worst combination of startup time and rebuffering?”
• “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, 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:

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

2. Add the following entry:

   JSON

   {
     "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

1. 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>"

2. 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.