Analytics MCP Server

The Analytics MCP Server allows AI assistants to pull streaming data, revenue performance, artificial stream metrics, and Top Movers data to generate natural language reports.

Beta Feature
Our MCP Servers are currently in BETA. They are under active development and are subject to breaking changes - some tools can result in 403 Forbidden or other errors.

Authentication

Use your existing Revelator Partner API credentials (partnerUserId and partnerApiKey) when your LLM prompts you to do so. This is usually only required initially when starting a new chat/session.

Server Details

Server Address: https://mcp.revelator.com/analytics

Supported Tools

Tool Name	Description
`Api_GetHealthcheck`	Checks the health and status of the Analytics API.
`ArtificialStreams_GetArtificialStreamsByTrack`	Retrieves flagged artificial stream data aggregated by track.
`ArtificialStreams_GetArtificialStreamsByRelease`	Retrieves flagged artificial stream data aggregated by release.
`ArtificialStreams_GetArtificialStreamsByArtist`	Retrieves flagged artificial stream data aggregated by artist.
`ArtificialStreams_GetArtificialStreamsByLabel`	Retrieves flagged artificial stream data aggregated by label.
`ArtificialStreams_GetArtificialStreamsByCountry`	Retrieves flagged artificial stream data aggregated by country.
`ArtificialStreams_GetArtificialStreamsByDistributor`	Retrieves flagged artificial stream data aggregated by DSP/Store.
`ArtificialStreams_GetArtificialStreamsByDate`	Retrieves daily trend data for flagged artificial streams.
`ArtificialStreams_GetArtificialStreamsByClient`	Retrieves artificial stream data aggregated by child enterprise/client.
`ArtificialStreams_GetArtificialStreamsByOrganization`	Retrieves overall artificial stream data for the parent organization.
`ArtificialStreams_GetArtificialStreamsDashboardByClient`	Retrieves high-level artificial stream dashboard metrics for a client.
`ArtificialStreams_GetArtificialStreamsDashboardByOrganiz`	Retrieves high-level artificial stream dashboard metrics for the organization.
`Consumption_GetConsumption`	Retrieves overall consumption (stream and download) analytics.
`Engagement_GetEngagementByTrack`	Retrieves user engagement metrics (skips, saves, playlist adds) by track.
`Engagement_GetEngagementByArtist`	Retrieves user engagement metrics by artist.
`Engagement_GetEngagementByRelease`	Retrieves user engagement metrics by release.
`Engagement_GetEngagementBySourceOfStream`	Retrieves engagement metrics grouped by where the stream originated (e.g., algorithmic playlist).
`Engagement_GetEngagementByDiscoveryType`	Retrieves engagement metrics based on user discovery methods.
`Engagement_GetEngagementByDistributor`	Retrieves engagement metrics grouped by DSP/Store.
`Engagement_GetEngagementByCountry`	Retrieves engagement metrics grouped by listener country.
`Engagement_GetEngagementByLabel`	Retrieves engagement metrics grouped by label.
`Engagement_GetEngagementByDeliveryType`	Retrieves engagement metrics based on delivery type (e.g., Premium vs. Ad-supported).
`Engagement_GetEngagementByRecordingVersion`	Retrieves engagement metrics for specific recording versions (e.g., Live vs. Studio).
`Engagement_GetEngagementByDate`	Retrieves a timeline of engagement metrics by date.
`Engagement_GetEngagementByConsumptionType`	Retrieves engagement grouped by consumption type (stream vs. download).
`Movement_GetMovement`	Retrieves Top Movers data (rising and falling entities) based on streams or revenue.
`Playlists_GetPlaylistsByMetadata`	Retrieves playlist placement data based on track metadata.
`Playlists_GetPlaylistMovements`	Retrieves data on tracks moving up or down within playlists.
`Revenue_GetRevenueByTrack`	Retrieves historical revenue data aggregated by track.
`Revenue_GetRevenueByDistributor`	Retrieves historical revenue data aggregated by DSP/Store.
`Revenue_GetRevenueByCountry`	Retrieves historical revenue data aggregated by market/country.
`Revenue_GetRevenueByDeliveryType`	Retrieves revenue grouped by subscription/delivery tier.
`Revenue_GetRevenueByArtist`	Retrieves historical revenue data aggregated by artist.
`Revenue_GetRevenuebyRelease`	Retrieves historical revenue data aggregated by release.
`Revenue_GetRevenuebyLabel`	Retrieves historical revenue data aggregated by label.
`Revenue_GetRevenuebyFormat`	Retrieves revenue grouped by format (e.g., Audio vs. Video).
`Revenue_GetRevenuebyYouTubeChannel`	Retrieves revenue generated by specific YouTube channels.
`Revenue_GetRevenuebyYouTubeVideo`	Retrieves revenue generated by specific YouTube videos.
`Revenue_GetRevenueMetricsByDate`	Retrieves total revenue performance plotted over a date range.