TopAIMuza.pl
Chart and catalogue of Polish AI-generated music: artists, tracks, genres, new releases.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~4,043토큰 (도구 정의)
~6.9 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.16%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ranking": {
"url": "https://topaimuza.pl/mcp"
}
}
}원격 엔드포인트
https://topaimuza.pl/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.
입력 스키마
{
"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
}출력 스키마
{
"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…”.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}출력 스키마
{
"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
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 6개