TopAIMuza.pl
Chart and catalogue of Polish AI-generated music: artists, tracks, genres, new releases.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~4,043Tokens (tool definitions)
~6.9 KBTypical response size
Significant attention impact (3.16% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"ranking": {
"url": "https://topaimuza.pl/mcp"
}
}
}Remote endpoints
https://topaimuza.pl/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_artists(query, genre, limit)
Search AI music artists in the TopAIMuza.pl catalogue by name (typos tolerated) and/or genre. Returns up to 25 artists with genres, TopAI chart position and profile link. With only a genre, artists are ordered by chart position. / Wyszukuje artystów muzyki AI po nazwie lub gatunku.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Artist or project name (or part of it). / Nazwa artysty."
},
"genre": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum results to return (1-25, default 10)."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"genre": {
"type": "string"
}
},
"additionalProperties": false
},
"genre": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"interpreted_as": {
"type": "string",
"description": "Name used after correcting a typo."
},
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
}
},
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"additionalProperties": false
}
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"required": [
"slug",
"name",
"artists"
],
"additionalProperties": false
}
},
"total_found": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢get_artist(artist)
Profile of one artist on TopAIMuza.pl by name, slug or profile URL: genres, description (from the creator or the editors), TopAI chart place with movement and platform figures (as on the profile), YouTube channel views and subscribers with the measurement date, listening links (YouTube, Spotify, Deezer, TIDAL, ...) and the latest tracks with links. / Profil artysty: gatunki, opis, pozycja, dane kanału YouTube z datą, linki „Słuchaj w…”.
Input Schema
{
"type": "object",
"properties": {
"artist": {
"type": "string",
"minLength": 2,
"maxLength": 200,
"description": "Artist name, slug or profile URL, e.g. https://topaimuza.pl/artysta/<slug>/ / Nazwa, slug albo adres profilu."
}
},
"required": [
"artist"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"not_found",
"ambiguous",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"artist": {
"type": "string"
}
},
"required": [
"artist"
],
"additionalProperties": false
},
"interpreted_as": {
"type": "string",
"description": "Name used after correcting a typo."
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
}
},
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"additionalProperties": false
}
},
"artist": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"profile_url": {
"type": "string"
},
"profile_url_en": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
}
},
"description": {
"type": [
"string",
"null"
],
"description": "Polish text from the creator or the editors; null = none."
},
"description_source": {
"type": [
"string",
"null"
],
"enum": [
"creator",
"editorial",
null
]
},
"ranking": {
"type": [
"object",
"null"
],
"properties": {
"position": {
"type": [
"integer",
"null"
],
"description": "Place in the main TopAI chart; null = not in it yet."
},
"tie": {
"type": "boolean"
},
"movement": {
"type": [
"object",
"null"
],
"description": "Movement since yesterday, as on the chart page; null = no history.",
"properties": {
"type": {
"type": "string",
"enum": [
"up",
"down",
"same",
"new"
]
},
"places": {
"type": [
"integer",
"null"
]
}
},
"required": [
"type",
"places"
],
"additionalProperties": false
},
"debut_position": {
"type": [
"integer",
"null"
],
"description": "Place on the Debuts list."
},
"platforms": {
"type": [
"object",
"null"
],
"description": "Real platform figures as on the profile, each with its read date; a missing platform = no reading, null = none.",
"properties": {
"youtube": {
"type": "object",
"properties": {
"track_views": {
"type": [
"integer",
"null"
]
},
"subscribers": {
"type": [
"integer",
"null"
]
},
"channel_views": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
},
"spotify": {
"type": "object",
"properties": {
"monthly_listeners": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
},
"youtube_music": {
"type": "object",
"properties": {
"track_views": {
"type": [
"integer",
"null"
]
},
"tracks": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
}
},
"additionalProperties": false
},
"as_of": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"ranking_url": {
"type": "string"
},
"methodology_url": {
"type": "string"
}
},
"required": [
"position",
"tie",
"movement",
"debut_position",
"platforms",
"as_of",
"updated_at",
"source",
"ranking_url",
"methodology_url"
],
"additionalProperties": false
},
"youtube_channel": {
"type": [
"object",
"null"
],
"properties": {
"views": {
"type": [
"integer",
"null"
]
},
"subscribers": {
"type": [
"integer",
"null"
]
},
"measured_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"source": {
"type": "string"
}
},
"required": [
"views",
"subscribers",
"measured_on",
"source"
],
"additionalProperties": false
},
"listen_links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"platform": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"platform",
"url"
],
"additionalProperties": false
}
},
"tracks_count": {
"type": "integer",
"description": "Track pages of this artist on topaimuza.pl."
},
"latest_tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"published_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"track_url": {
"type": "string"
}
},
"required": [
"title",
"published_on",
"track_url"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"slug",
"profile_url",
"profile_url_en",
"genres",
"description",
"description_source",
"ranking",
"youtube_channel",
"listen_links",
"tracks_count",
"latest_tracks"
],
"additionalProperties": false
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢top_ranking(genre, limit)
Top of the TopAI chart of Polish AI music on TopAIMuza.pl (the same places as topaimuza.pl/ranking/topai/), optionally within one genre: place, movement since yesterday, artist, genres, real platform figures (YouTube, Spotify, YouTube Music) with read dates and profile link. Up to 25 places. / Czołówka rankingu polskiej muzyki AI (te same miejsca co na stronie), opcjonalnie w gatunku.
Input Schema
{
"type": "object",
"properties": {
"genre": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum results to return (1-25, default 10)."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"genre": {
"type": "string"
},
"limit": {
"type": "integer"
}
},
"additionalProperties": false
},
"genre": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"as_of": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"ranking_url": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"total_ranked": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"position": {
"type": "integer"
},
"tie": {
"type": "boolean"
},
"movement": {
"type": [
"object",
"null"
],
"description": "Movement since yesterday, as on the chart page; null = no history.",
"properties": {
"type": {
"type": "string",
"enum": [
"up",
"down",
"same",
"new"
]
},
"places": {
"type": [
"integer",
"null"
]
}
},
"required": [
"type",
"places"
],
"additionalProperties": false
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"platforms": {
"type": [
"object",
"null"
],
"description": "Real platform figures as on the profile, each with its read date; a missing platform = no reading, null = none.",
"properties": {
"youtube": {
"type": "object",
"properties": {
"track_views": {
"type": [
"integer",
"null"
]
},
"subscribers": {
"type": [
"integer",
"null"
]
},
"channel_views": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
},
"spotify": {
"type": "object",
"properties": {
"monthly_listeners": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
},
"youtube_music": {
"type": "object",
"properties": {
"track_views": {
"type": [
"integer",
"null"
]
},
"tracks": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
}
}
},
"additionalProperties": false
},
"profile_url": {
"type": "string"
}
},
"required": [
"position",
"tie",
"movement",
"name",
"slug",
"genres",
"platforms",
"profile_url"
],
"additionalProperties": false
}
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"required": [
"slug",
"name",
"artists"
],
"additionalProperties": false
}
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢search_tracks(title, artist, limit)
Search track pages on TopAIMuza.pl by title, optionally by one artist. Returns title, artist, release date and links to the track page and the artist profile. Up to 25 tracks. / Wyszukuje utwory po tytule (opcjonalnie u jednego artysty) z linkiem do karty utworu.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Track title or part of it. / Tytuł utworu."
},
"artist": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Optional artist name or slug. / Artysta (opcjonalnie)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum results to return (1-25, default 10)."
}
},
"required": [
"title"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"artist_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
}
},
"additionalProperties": false
},
"artist": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"profile_url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"profile_url"
],
"additionalProperties": false
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
}
},
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"additionalProperties": false
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
},
"artist_slug": {
"type": "string"
},
"published_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"track_url": {
"type": "string"
},
"track_url_en": {
"type": "string"
},
"artist_url": {
"type": "string"
}
},
"required": [
"title",
"artist",
"artist_slug",
"published_on",
"track_url",
"track_url_en",
"artist_url"
],
"additionalProperties": false
}
},
"total_found": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢new_releases(genre, limit)
Newest track pages in the TopAIMuza.pl catalogue of Polish AI music, optionally within one genre: title, artist, release date and links to the track page and the artist profile. Up to 25 tracks. / Najnowsze utwory w katalogu TopAIMuza.pl, opcjonalnie w jednym gatunku, z linkami do kart.
Input Schema
{
"type": "object",
"properties": {
"genre": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum results to return (1-25, default 10)."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"genre": {
"type": "string"
},
"limit": {
"type": "integer"
}
},
"additionalProperties": false
},
"genre": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"new_releases_url": {
"type": "string"
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
},
"artist_slug": {
"type": "string"
},
"published_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"track_url": {
"type": "string"
},
"track_url_en": {
"type": "string"
},
"artist_url": {
"type": "string"
}
},
"required": [
"title",
"artist",
"artist_slug",
"published_on",
"track_url",
"track_url_en",
"artist_url"
],
"additionalProperties": false
}
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"required": [
"slug",
"name",
"artists"
],
"additionalProperties": false
}
},
"total_found": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢list_genres
Genres of the TopAIMuza.pl catalogue (e.g. disco polo, rap, pop, rock) with the number of artist profiles and a link to each genre page. / Gatunki w katalogu z liczbą artystów i linkiem do strony gatunku.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"genres_url": {
"type": "string"
},
"returned": {
"type": "integer"
},
"genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"artists": {
"type": "integer"
},
"genre_url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"artists",
"genre_url"
],
"additionalProperties": false
}
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded6 tools