MCP Radar
Serveur MCP

Bitmovin Observability MCP

com.bitmovin.mcp.analytics/analytics-mcp
Données et analytique Médias et contenu Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Queries and analyzes Bitmovin playback observability data across sessions, time ranges, metrics, filters, licenses, and advertising dimensions.

Capacités

Outils

11 outils
analyzeImpression
Analyze impression
Deep-dive analysis of a SINGLE playback session identified by a specific impressionId: static properties, aggregated metrics, state-transition timeline, and an AI-powered interpretation of session quality. Use for detailed single-session troubleshooting. REQUIRES an impressionId. Do NOT use this for license-wide metrics, totals, trends, or any time-range ('last week', start/end) analysis — this tool does not accept start/end. For metrics over a time period use the 'query' tool; for breakdowns by category use 'queryGroupBy'.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['impressionId', 'licenseKey'], 'properties': {'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}, 'impressionId': {'type': 'string', 'description': 'Impression ID'}}, 'additionalProperties': False}
fetchImpressions
List impression ids for a timeframe
List the impression ids (individual playback session ids) for a license over a time range, optionally narrowed by filters. Returns the ids themselves — NOT counts, totals, or trends. Use this to enumerate sessions before drilling into specific ones with `getImpressionOverview` or `analyzeImpression`. Typical uses: 'give me impression ids from yesterday', 'list sessions on Safari that errored last week', 'sample sessions from country US'. Every matching session is eligible (including failed/setup sessions), not only successful plays. Results are capped (default 100, max 200); if truncated, narrow the timeframe/filters or raise `limit`. A licenseKey is required, and `peekAllLicenses` lists the available ones; `searchFilters` resolves the filter attributes and operators used by the optional `filters` input. For metric counts/trends over a period use `query` / `queryTotal`; for category breakdowns use `queryGroupBy`.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['licenseKey', 'start', 'end'], 'properties': {'end': {'type': 'string', 'description': "end date/time in ISO 8601 format (e.g., '2025-10-02T00:00:00')"}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'maximum number of impression ids to return (1-200, default 100)'}, 'start': {'type': 'string', 'description': "start date/time in ISO 8601 format (e.g., '2025-10-01T00:00:00')"}, 'filters': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'operator', 'value'], 'properties': {'name': {'type': 'string', 'description': 'category name to filter on'}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'array', 'items': {'type': ['string', 'number']}}], 'description': "the value to filter by. For 'in' operator, provide an array of values"}, 'operator': {'enum': ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'contains'], 'type': 'string', 'description': 'the filter operator'}}, 'additionalProperties': False}, 'description': 'optional filters to apply to the query'}, 'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}}, 'additionalProperties': False}
getAvailableFilters
Get available filters
List the full catalog of filter attributes with their supported operators. Prefer searchFilters to resolve a single attribute; use this only when you need every filter.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}}, 'additionalProperties': False}
getAvailableMetrics
Get available metrics
List the full catalog of metrics with their supported aggregation methods. Prefer searchMetrics to resolve a single keyword; use this only when you need every metric.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
getImpressionOverview
Get impression overview
Inspect a SINGLE playback session identified by a specific impressionId. Returns that one session's static properties (device, location, player) and its aggregated metrics (total played time, buffering, video quality). REQUIRES an impressionId. Do NOT use this for license-wide metrics, totals, trends, or any time-range ('last week', start/end) analysis — this tool does not accept start/end. For metrics over a time period use the 'query' tool; for breakdowns by category use 'queryGroupBy'.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['impressionId', 'licenseKey'], 'properties': {'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}, 'impressionId': {'type': 'string', 'description': 'Impression ID'}}, 'additionalProperties': False}
peekAllLicenses
Peek all licenses
View a summary of all available licenses with their recent play counts and percentage distribution. Use this to understand what licenses exist and their relative usage. When a user asks about licenses by ranking (e.g., 'biggest', 'most active', 'first'), use this to identify which license matches that criteria before querying.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
query
Query timeseries metric
Query a metric over a time range (start/end) for a license as a TIME SERIES — always renders a chart. Use this for trends and license-wide analytics over a period (e.g. 'last week', 'last 30 days', 'yesterday'). Bucket size is chosen automatically from start/end; there is no interval field to set. For a single aggregated number (one total/average over the whole period, NO chart), use the separate `queryTotal` tool instead. Queries resolve against API metric keywords, which can differ from a metric's common name — 'plays', for example, is 'impression_id'. The 'searchMetrics' tool resolves a keyword cheaply; 'getAvailableMetrics' returns the full catalog. Every query needs a licenseKey; `peekAllLicenses` lists the ones available. AD ANALYTICS: ad metrics use 'ad_'-prefixed keywords and are queried against a separate ads dataset. The ad completion funnel is: 'ad_quartile_1' (first quartile / 25%) -> 'ad_midpoint' (50%) -> 'ad_quartile_3' (third quartile / 75%) -> 'ad_completions'. Other ad metrics: 'ad_impressions', 'ad_starts', 'ad_clicks', 'ad_skips', 'ad_startup_time', 'ad_error_percentage', 'ad_error_sessions', 'ad_time_played', 'ad_play_percentage', 'ad_unique_users'. Ad data is present on some licenses and not others; `peekAllLicenses` output shows which. A query covers a single license, so an ad question resolves against one license at a time. With an ad metric, filters and groupBy take the AD-specific attributes from 'searchFilters' / 'getAvailableFilters' (e.g. 'AD_SYSTEM', 'AD_POSITION', 'ADVERTISER_NAME'); playback attributes and ad attributes are not interchangeable. OPTIONAL 3) Use the 'searchFilters' tool to find filter attributes/operators (or 'getAvailableFilters' for the full list).
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['licenseKey', 'metric', 'start', 'end'], 'properties': {'end': {'type': 'string', 'description': "end date/time in ISO 8601 format (e.g., '2025-10-02T00:00:00')"}, 'start': {'type': 'string', 'description': "start date/time in ISO 8601 format (e.g., '2025-10-01T00:00:00')"}, 'metric': {'type': 'string', 'description': 'the metric to query. before setting a value, resolve the keyword with the `searchMetrics` tool'}, 'filters': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'operator', 'value'], 'properties': {'name': {'type': 'string', 'description': 'category name to filter on'}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'array', 'items': {'type': ['string', 'number']}}], 'description': "the value to filter by. For 'in' operator, provide an array of values"}, 'operator': {'enum': ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'contains'], 'type': 'string', 'description': 'the filter operator'}}, 'additionalProperties': False}, 'description': 'optional filters to apply to the query'}, 'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}, 'percentile': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': "percentile value (0-100) - required when aggregation is 'percentile'"}, 'aggregation': {'enum': ['count', 'average', 'median', 'percentile', 'sum'], 'type': 'string', 'description': "aggregation method: 'average', 'median', or 'percentile'. If not specified, uses the metric's default aggregation method"}}, 'additionalProperties': False}
queryGroupBy
Query metric grouped by categories
query metric grouped by categories. Queries resolve against API metric keywords, which can differ from a metric's common name — 'plays', for example, is 'impression_id'. The 'searchMetrics' tool resolves a keyword cheaply; 'getAvailableMetrics' returns the full catalog. Every query needs a licenseKey; `peekAllLicenses` lists the ones available. AD ANALYTICS: ad metrics use 'ad_'-prefixed keywords and are queried against a separate ads dataset. The ad completion funnel is: 'ad_quartile_1' (first quartile / 25%) -> 'ad_midpoint' (50%) -> 'ad_quartile_3' (third quartile / 75%) -> 'ad_completions'. Other ad metrics: 'ad_impressions', 'ad_starts', 'ad_clicks', 'ad_skips', 'ad_startup_time', 'ad_error_percentage', 'ad_error_sessions', 'ad_time_played', 'ad_play_percentage', 'ad_unique_users'. Ad data is present on some licenses and not others; `peekAllLicenses` output shows which. A query covers a single license, so an ad question resolves against one license at a time. With an ad metric, filters and groupBy take the AD-specific attributes from 'searchFilters' / 'getAvailableFilters' (e.g. 'AD_SYSTEM', 'AD_POSITION', 'ADVERTISER_NAME'); playback attributes and ad attributes are not interchangeable. The groupBy attribute is an exact API attribute name, and common guesses are often wrong: 'OPERATING_SYSTEM' is invalid where 'OPERATINGSYSTEM' is correct, and an unrecognised attribute fails with a validation error. The 'searchFilters' tool resolves an attribute name; 'getAvailableFilters' returns the full catalog. Results grouped by ERROR_CODE carry occurrence counts but not error semantics, which are Bitmovin-specific and documented in the live Bitmovin documentation served by the docs MCP tool (typically `general_docs_ask_bitmovin_docs`). That tool resolves one numeric error code per call and returns nothing usable for a question naming several codes at once.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['licenseKey', 'metric', 'start', 'end', 'groupBy'], 'properties': {'end': {'type': 'string', 'description': "end date/time in ISO 8601 format (e.g., '2025-10-02T00:00:00')"}, 'start': {'type': 'string', 'description': "start date/time in ISO 8601 format (e.g., '2025-10-01T00:00:00')"}, 'metric': {'type': 'string', 'description': 'the metric to query. before setting a value, resolve the keyword with the `searchMetrics` tool'}, 'filters': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'operator', 'value'], 'properties': {'name': {'type': 'string', 'description': 'category name to filter on'}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'array', 'items': {'type': ['string', 'number']}}], 'description': "the value to filter by. For 'in' operator, provide an array of values"}, 'operator': {'enum': ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'contains'], 'type': 'string', 'description': 'the filter operator'}}, 'additionalProperties': False}, 'description': 'optional filters to apply to the query'}, 'groupBy': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': "category (or array of categories) to group results by â\x80\x94 e.g. Case-insensitive: ['BROWSER', 'COUNTRY'] or just 'BROWSER'. Prefer an array even for a single value. Use the `searchFilters` tool (pass the licenseKey) to resolve the valid attribute names."}, 'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}, 'percentile': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': "percentile value (0-100) - required when aggregation is 'percentile'"}, 'aggregation': {'enum': ['count', 'average', 'median', 'percentile', 'sum'], 'type': 'string', 'description': "aggregation method: 'average', 'median', or 'percentile'. If not specified, uses the metric's default aggregation method"}}, 'additionalProperties': False}
queryTotal
Get an aggregated metric value (one or more metrics)
Get an aggregated value (one number) for a metric over a time range — no chart, no time bucketing. Can fetch SEVERAL metrics in one call: pass an array to `metric` to get one value per metric (e.g. the ad completion funnel), instead of calling this tool repeatedly. Use ONLY when the user asks for totals/averages/median/p95 over a whole period (e.g. 'total plays last month', 'average startup time yesterday', 'p95 rebuffer last week', 'the ad funnel counts last week'). For trends or any 'how did X change over time' / 'show last week' question, use the `query` tool instead — it always renders a chart. Queries resolve against API metric keywords, which can differ from a metric's common name — 'plays', for example, is 'impression_id'. The 'searchMetrics' tool resolves a keyword cheaply; 'getAvailableMetrics' returns the full catalog. Every query needs a licenseKey; `peekAllLicenses` lists the ones available. AD ANALYTICS: ad metrics use 'ad_'-prefixed keywords and are queried against a separate ads dataset. The ad completion funnel is: 'ad_quartile_1' (first quartile / 25%) -> 'ad_midpoint' (50%) -> 'ad_quartile_3' (third quartile / 75%) -> 'ad_completions'. Other ad metrics: 'ad_impressions', 'ad_starts', 'ad_clicks', 'ad_skips', 'ad_startup_time', 'ad_error_percentage', 'ad_error_sessions', 'ad_time_played', 'ad_play_percentage', 'ad_unique_users'. Ad data is present on some licenses and not others; `peekAllLicenses` output shows which. A query covers a single license, so an ad question resolves against one license at a time. With an ad metric, filters and groupBy take the AD-specific attributes from 'searchFilters' / 'getAvailableFilters' (e.g. 'AD_SYSTEM', 'AD_POSITION', 'ADVERTISER_NAME'); playback attributes and ad attributes are not interchangeable.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['licenseKey', 'metric', 'start', 'end'], 'properties': {'end': {'type': 'string', 'description': "end date/time in ISO 8601 format (e.g., '2025-10-02T00:00:00')"}, 'start': {'type': 'string', 'description': "start date/time in ISO 8601 format (e.g., '2025-10-01T00:00:00')"}, 'metric': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': "the metric to query: a single keyword, or an array of up to 6 keywords resolved together in one call, which returns one value per metric. A multi-metric ask such as the ad completion funnel is one array â\x80\x94 ['ad_quartile_1','ad_midpoint','ad_quartile_3','ad_completions'] â\x80\x94 rather than one call each. Keywords are the API's own names, which the `searchMetrics` tool resolves."}, 'filters': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'operator', 'value'], 'properties': {'name': {'type': 'string', 'description': 'category name to filter on'}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'array', 'items': {'type': ['string', 'number']}}], 'description': "the value to filter by. For 'in' operator, provide an array of values"}, 'operator': {'enum': ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'contains'], 'type': 'string', 'description': 'the filter operator'}}, 'additionalProperties': False}, 'description': 'optional filters to apply to the query'}, 'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}, 'percentile': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': "percentile value (0-100) - required when aggregation is 'percentile'"}, 'aggregation': {'enum': ['count', 'average', 'median', 'percentile', 'sum'], 'type': 'string', 'description': "aggregation method: 'average', 'median', or 'percentile'. If not specified, uses the metric's default aggregation method"}}, 'additionalProperties': False}
searchFilters
Search filters
Find the exact filter/group-by attribute keyword for a topic or question (e.g. 'browser', 'device type', 'content tier'). Preferred way to resolve an attribute; use 'licenseKey' to resolve custom namings of attributes; use getAvailableFilters only to list the full static catalog.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'maximum number of results to return (default 5)'}, 'query': {'type': 'string', 'description': "free-text term or question describing the metric/filter you want (e.g., 'buffering', 'browser', 'how many errors')"}, 'licenseKey': {'type': 'string', 'format': 'uuid', 'description': 'license key (uuid) to query'}}, 'additionalProperties': False}
searchMetrics
Search metrics
Find the exact metric keyword for a topic or question (e.g. 'buffering', 'how many errors'). Preferred way to resolve a metric keyword; use getAvailableMetrics only to list the full catalog.
Lecture seule Accès externe
Schéma d’entrée 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'maximum number of results to return (default 5)'}, 'query': {'type': 'string', 'description': "free-text term or question describing the metric/filter you want (e.g., 'buffering', 'browser', 'how many errors')"}}, 'additionalProperties': False}
Historique

Modifications récentes des outils

Modifié
queryTotal
19 September 2026 02:50
Ajouté
searchFilters
17 September 2026 12:34
Ajouté
searchMetrics
17 September 2026 12:34
Ajouté
getAvailableFilters
17 September 2026 12:34
Ajouté
getAvailableMetrics
17 September 2026 12:34
Ajouté
fetchImpressions
17 September 2026 12:34
Ajouté
analyzeImpression
17 September 2026 12:34
Ajouté
getImpressionOverview
17 September 2026 12:33
Ajouté
peekAllLicenses
17 September 2026 12:33
Ajouté
queryTotal
17 September 2026 12:33
Ajouté
queryGroupBy
17 September 2026 12:33
Ajouté
query
17 September 2026 12:33
Découvrir

Serveurs MCP similaires

UFCalendar Fight API — MMA MCP server

com.ufcalendar/fight-api

Provides MMA event, fighter, bout, rankings, broadcast, judging, live statistics, prediction, and webhook data across multiple pr…

Mlb Stats

io.github.pipeworx-io/mlb-stats

Provides official MLB schedules, scores, standings, rosters, player statistics, game logs, matchups, probable pitchers, lineups, …

Football Data

io.github.pipeworx-io/football-data

Retrieves soccer competitions, matches, team details, standings, schedules, and competition metadata.

Openf1

io.github.pipeworx-io/openf1

Provides live and historical Formula 1 meeting, session, driver, lap, timing, and telemetry data.

Openligadb

io.github.pipeworx-io/openligadb

Provides football and soccer league listings, fixtures, match results, and standings.

Gdelt

io.github.pipeworx-io/gdelt

Provides access to GDELT global news and event data for researching events, media coverage, language, and tone.

extract

com.mart402/extract

Extracts and verifies information from webpages, PDFs, images, invoices, payslips, and company sources, with OCR, document parsin…

Mukoko News

io.github.nyuchi/mukoko-news

Searches and reads African news, provides regional briefings and source views, tracks stories, and analyzes coverage trends, cate…