Cursor
Grok Bot
Grok
MuseTitle96/100
Get a saved artist airplay report
The title clearly communicates the tool’s action and subject. Keep it concise.
Description92/100
Read a detailed airplay report for one artist saved on the authenticated account’s roster: top songs, supporting stations, trends, and new detections. Matches the artist by their saved roster name. Read-only; it does not change the roster.
The description explains the capability, when to use it, and what to expect.
Inputs33/100
1 of 3 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
artist
The artist name saved on your roster.
Clear enough to supply this argument.
days
Not provided
Missing description. Explain what this value means and how to supply it.
limit
Not provided
Missing description. Explain what this value means and how to supply it.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"title": "Get a saved artist airplay report",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Output schema63/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"artist",
"days",
"generatedAt",
"dataThroughDay",
"coverageStartDay",
"periodSongCount",
"metrics",
"trendGranularity",
"trend",
"songs",
"stations",
"firstDetectedSongs",
"firstDetectedStations",
"latestPlays",
"sourceUrl",
"notes"
],
"properties": {
"days": {
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 90
},
{
"type": "number",
"const": 365
}
]
},
"notes": {
"type": "string"
},
"songs": {
"type": "array",
"items": {
"type": "object",
"required": [
"track",
"topStationId",
"spins",
"previousSpins",
"changePercent",
"changeState",
"artistSharePercent"
],
"properties": {
"spins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"track": {
"type": "object",
"required": [
"id",
"key",
"title",
"artists"
],
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"title": {
"type": "string"
},
"artists": {
"type": "string"
}
},
"additionalProperties": {}
},
"changeState": {
"enum": [
"up",
"down",
"flat",
"new",
"insufficient_history"
],
"type": "string"
},
"topStationId": {
"type": [
"string",
"null"
]
},
"changePercent": {
"type": [
"number",
"null"
]
},
"previousSpins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"artistSharePercent": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": {}
}
},
"trend": {
"type": "array",
"items": {
"type": "object",
"required": [
"bucket",
"spins",
"complete"
],
"properties": {
"spins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"bucket": {
"type": "string"
},
"complete": {
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"artist": {
"type": "object",
"required": [
"displayName",
"resolvedTrackCount"
],
"properties": {
"displayName": {
"type": "string"
},
"resolvedTrackCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": {}
},
"metrics": {
"type": "object",
"required": [
"todaySpins",
"periods",
"typicalWeek"
],
"properties": {
"periods": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"spins",
"previousSpins",
"previousYearSpins",
"changePercent",
"changeState",
"yearOverYearChangePercent",
"yearOverYearChangeState"
],
"properties": {
"days": {
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 90
},
{
"type": "number",
"const": 365
}
]
},
"spins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"changeState": {
"enum": [
"up",
"down",
"flat",
"new",
"insufficient_history"
],
"type": "string"
},
"changePercent": {
"type": [
"number",
"null"
]
},
"previousSpins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"previousYearSpins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"yearOverYearChangeState": {
"enum": [
"up",
"down",
"flat",
"new",
"insufficient_history"
],
"type": "string"
},
"yearOverYearChangePercent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
},
"todaySpins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"typicalWeek": {
"type": "object",
"required": [
"spins",
"multiple",
"changePercent",
"changeState"
],
"properties": {
"spins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"multiple": {
"type": [
"number",
"null"
]
},
"changeState": {
"enum": [
"up",
"down",
"flat",
"new",
"insufficient_history"
],
"type": "string"
},
"changePercent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"stations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"isVisible",
"spins",
"previousSpins",
"changePercent",
"changeState",
"artistSharePercent",
"stationSharePercent"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"spins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"isVisible": {
"type": "boolean"
},
"changeState": {
"enum": [
"up",
"down",
"flat",
"new",
"insufficient_history"
],
"type": "string"
},
"changePercent": {
"type": [
"number",
"null"
]
},
"previousSpins": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"artistSharePercent": {
"type": "number",
"minimum": 0
},
"stationSharePercent": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
}
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"generatedAt": {
"type": "string"
},
"latestPlays": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"playedAt",
"station",
"track"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"track": {
"type": "object",
"required": [
"id",
"key",
"title",
"artists"
],
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"title": {
"type": "string"
},
"artists": {
"type": "string"
}
},
"additionalProperties": {}
},
"station": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": {}
},
"playedAt": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"dataThroughDay": {
"type": "string"
},
"periodSongCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"coverageStartDay": {
"type": [
"string",
"null"
]
},
"trendGranularity": {
"enum": [
"day",
"week"
],
"type": "string"
},
"firstDetectedSongs": {
"type": "array",
"items": {
"type": "object",
"required": [
"firstDetectedAt",
"stationCount",
"track"
],
"properties": {
"track": {
"type": "object",
"required": [
"id",
"key",
"title",
"artists"
],
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"title": {
"type": "string"
},
"artists": {
"type": "string"
}
},
"additionalProperties": {}
},
"stationCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"firstDetectedAt": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"firstDetectedStations": {
"type": "array",
"items": {
"type": "object",
"required": [
"firstDetectedAt",
"station",
"firstTrack"
],
"properties": {
"station": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": {}
},
"firstTrack": {
"type": "object",
"required": [
"id",
"key",
"title",
"artists"
],
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"title": {
"type": "string"
},
"artists": {
"type": "string"
}
},
"additionalProperties": {}
},
"firstDetectedAt": {
"type": "string"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
}