TopAIMuza MCP
A remote MCP server providing read-only access to the TopAIMuza catalog of Polish AI-generated music. It allows AI agents to search for artists and tracks, retrieve artist profiles with ranking data, view the top AI music ranking, list genres, and fetch new releases, all sourced from official APIs and public artist pages.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://topaimuza.pl/mcpWhat you can do with it
- Search for artists by name or genre
- Retrieve artist profiles and ranking positions
- View the top AI music ranking chart
- Find new music releases and genres
Source and maintenance
Vendor evidenceRegistry 1.0.0
Protocol and capabilities
- Server
- topaimuza 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
search_artists — Search artists / Szukaj artystów
Advertised read-only
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.
search_artists input schema
{
"type": "object",
"properties": {
"genre": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum results to return (1-25, default 10)."
},
"query": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Artist or project name (or part of it). / Nazwa artysty."
}
},
"additionalProperties": false
}search_artists output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"genre": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
},
"query": {
"type": "object",
"properties": {
"genre": {
"type": "string"
},
"query": {
"type": "string"
}
},
"additionalProperties": false
},
"status": {
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"artists": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
}
},
"additionalProperties": false
}
},
"message": {
"type": "string"
},
"returned": {
"type": "integer"
},
"total_found": {
"type": "integer"
},
"interpreted_as": {
"type": "string",
"description": "Name used after correcting a typo."
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"artists"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}search_artists annotations
{
"title": "Search artists / Szukaj artystów",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_artist — Artist profile / Profil artysty
Advertised read-only
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…”.
get_artist input schema
{
"type": "object",
"required": [
"artist"
],
"properties": {
"artist": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Artist name, slug or profile URL, e.g. https://topaimuza.pl/artysta/<slug>/ / Nazwa, slug albo adres profilu."
}
},
"additionalProperties": false
}get_artist output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"query": {
"type": "object",
"required": [
"artist"
],
"properties": {
"artist": {
"type": "string"
}
},
"additionalProperties": false
},
"artist": {
"type": "object",
"required": [
"name",
"slug",
"profile_url",
"profile_url_en",
"genres",
"description",
"description_source",
"ranking",
"youtube_channel",
"listen_links",
"tracks_count",
"latest_tracks"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
}
},
"ranking": {
"type": [
"object",
"null"
],
"required": [
"position",
"tie",
"movement",
"debut_position",
"platforms",
"as_of",
"updated_at",
"source",
"ranking_url",
"methodology_url"
],
"properties": {
"tie": {
"type": "boolean"
},
"as_of": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"source": {
"type": "string"
},
"movement": {
"type": [
"object",
"null"
],
"required": [
"type",
"places"
],
"properties": {
"type": {
"enum": [
"up",
"down",
"same",
"new"
],
"type": "string"
},
"places": {
"type": [
"integer",
"null"
]
}
},
"description": "Movement since yesterday, as on the chart page; null = no history.",
"additionalProperties": false
},
"position": {
"type": [
"integer",
"null"
],
"description": "Place in the main TopAI chart; null = not in it yet."
},
"platforms": {
"type": [
"object",
"null"
],
"properties": {
"spotify": {
"type": "object",
"properties": {
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"monthly_listeners": {
"type": [
"integer",
"null"
]
}
}
},
"youtube": {
"type": "object",
"properties": {
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"subscribers": {
"type": [
"integer",
"null"
]
},
"track_views": {
"type": [
"integer",
"null"
]
},
"channel_views": {
"type": [
"integer",
"null"
]
}
}
},
"youtube_music": {
"type": "object",
"properties": {
"tracks": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"track_views": {
"type": [
"integer",
"null"
]
}
}
}
},
"description": "Real platform figures as on the profile, each with its read date; a missing platform = no reading, null = none.",
"additionalProperties": false
},
"updated_at": {
"type": [
"string",
"null"
]
},
"ranking_url": {
"type": "string"
},
"debut_position": {
"type": [
"integer",
"null"
],
"description": "Place on the Debuts list."
},
"methodology_url": {
"type": "string"
}
},
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
],
"description": "Polish text from the creator or the editors; null = none."
},
"profile_url": {
"type": "string"
},
"listen_links": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"url"
],
"properties": {
"url": {
"type": "string"
},
"platform": {
"type": "string"
}
},
"additionalProperties": false
}
},
"tracks_count": {
"type": "integer",
"description": "Track pages of this artist on topaimuza.pl."
},
"latest_tracks": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"published_on",
"track_url"
],
"properties": {
"title": {
"type": "string"
},
"track_url": {
"type": "string"
},
"published_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
}
},
"additionalProperties": false
}
},
"profile_url_en": {
"type": "string"
},
"youtube_channel": {
"type": [
"object",
"null"
],
"required": [
"views",
"subscribers",
"measured_on",
"source"
],
"properties": {
"views": {
"type": [
"integer",
"null"
]
},
"source": {
"type": "string"
},
"measured_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"subscribers": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
},
"description_source": {
"enum": [
"creator",
"editorial",
null
],
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"status": {
"enum": [
"found",
"not_found",
"ambiguous",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"message": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
}
},
"additionalProperties": false
}
},
"interpreted_as": {
"type": "string",
"description": "Name used after correcting a typo."
}
},
"additionalProperties": false
}get_artist annotations
{
"title": "Artist profile / Profil artysty",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}top_ranking — TopAI chart / Ranking TopAI
Advertised read-only
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.
top_ranking input schema
{
"type": "object",
"properties": {
"genre": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum results to return (1-25, default 10)."
}
},
"additionalProperties": false
}top_ranking output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"as_of": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"genre": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
},
"query": {
"type": "object",
"properties": {
"genre": {
"type": "string"
},
"limit": {
"type": "integer"
}
},
"additionalProperties": false
},
"source": {
"type": "string"
},
"status": {
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"position",
"tie",
"movement",
"name",
"slug",
"genres",
"platforms",
"profile_url"
],
"properties": {
"tie": {
"type": "boolean"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"movement": {
"type": [
"object",
"null"
],
"required": [
"type",
"places"
],
"properties": {
"type": {
"enum": [
"up",
"down",
"same",
"new"
],
"type": "string"
},
"places": {
"type": [
"integer",
"null"
]
}
},
"description": "Movement since yesterday, as on the chart page; null = no history.",
"additionalProperties": false
},
"position": {
"type": "integer"
},
"platforms": {
"type": [
"object",
"null"
],
"properties": {
"spotify": {
"type": "object",
"properties": {
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"monthly_listeners": {
"type": [
"integer",
"null"
]
}
}
},
"youtube": {
"type": "object",
"properties": {
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"subscribers": {
"type": [
"integer",
"null"
]
},
"track_views": {
"type": [
"integer",
"null"
]
},
"channel_views": {
"type": [
"integer",
"null"
]
}
}
},
"youtube_music": {
"type": "object",
"properties": {
"tracks": {
"type": [
"integer",
"null"
]
},
"read_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"track_views": {
"type": [
"integer",
"null"
]
}
}
}
},
"description": "Real platform figures as on the profile, each with its read date; a missing platform = no reading, null = none.",
"additionalProperties": false
},
"profile_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"message": {
"type": "string"
},
"returned": {
"type": "integer"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"ranking_url": {
"type": "string"
},
"total_ranked": {
"type": "integer"
},
"methodology_url": {
"type": "string"
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"artists"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}top_ranking annotations
{
"title": "TopAI chart / Ranking TopAI",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_tracks — Search tracks / Szukaj utworów
Advertised read-only
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.
search_tracks input schema
{
"type": "object",
"required": [
"title"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum results to return (1-25, default 10)."
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Track title or part of it. / Tytuł utworu."
},
"artist": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Optional artist name or slug. / Artysta (opcjonalnie)."
}
},
"additionalProperties": false
}search_tracks output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"query": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
}
},
"additionalProperties": false
},
"artist": {
"type": "object",
"required": [
"name",
"slug",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"profile_url": {
"type": "string"
}
},
"additionalProperties": false
},
"status": {
"enum": [
"found",
"no_results",
"artist_not_found",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"artist",
"artist_slug",
"published_on",
"track_url",
"track_url_en",
"artist_url"
],
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
},
"track_url": {
"type": "string"
},
"artist_url": {
"type": "string"
},
"artist_slug": {
"type": "string"
},
"published_on": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"track_url_en": {
"type": "string"
}
},
"additionalProperties": false
}
},
"message": {
"type": "string"
},
"returned": {
"type": "integer"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"slug",
"genres",
"ranking_position",
"profile_url"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre names in Polish."
},
"profile_url": {
"type": "string",
"description": "Artist profile on topaimuza.pl."
},
"ranking_position": {
"type": [
"integer",
"null"
],
"description": "Place in the TopAI chart; null = not ranked."
}
},
"additionalProperties": false
}
},
"total_found": {
"type": "integer"
}
},
"additionalProperties": false
}search_tracks annotations
{
"title": "Search tracks / Szukaj utworów",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}new_releases — New releases / Nowości
Advertised read-only
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.
new_releases input schema
{
"type": "object",
"properties": {
"genre": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "Genre slug or Polish name, e.g. disco-polo, rap, pop, rock, dance, biesiada, slaskie. / Gatunek."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum results to return (1-25, default 10)."
}
},
"additionalProperties": false
}new_releases output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"genre": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
},
"query": {
"type": "object",
"properties": {
"genre": {
"type": "string"
},
"limit": {
"type": "integer"
}
},
"additionalProperties": false
},
"status": {
"enum": [
"found",
"no_results",
"genre_not_found",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"artist",
"artist_slug",
"published_on",
"track_url",
"track_url_en",
"artist_url"
],
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
},
"track_url": {
"type": "string"
},
"artist_url": {
"type": "string"
},
"artist_slug": {
"type": "string"
},
"published_on": {
"type": "string",
"description": "YYYY-MM-DD"
},
"track_url_en": {
"type": "string"
}
},
"additionalProperties": false
}
},
"message": {
"type": "string"
},
"returned": {
"type": "integer"
},
"total_found": {
"type": "integer"
},
"available_genres": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"artists"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"artists": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"new_releases_url": {
"type": "string"
}
},
"additionalProperties": false
}new_releases annotations
{
"title": "New releases / Nowości",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_genres — Genres / Gatunki
Advertised read-only
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.
list_genres input schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}list_genres output schema
{
"type": "object",
"required": [
"ok",
"status"
],
"properties": {
"ok": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
},
"genres": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"artists",
"genre_url"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"artists": {
"type": "integer"
},
"genre_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"enum": [
"found",
"no_results",
"invalid_request",
"temporary_error"
],
"type": "string"
},
"message": {
"type": "string"
},
"returned": {
"type": "integer"
},
"genres_url": {
"type": "string"
}
},
"additionalProperties": false
}list_genres annotations
{
"title": "Genres / Gatunki",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 725 ms
- 95th percentile latency
- 725 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 725 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http topaimuza-mcp https://topaimuza.pl/mcpCodex
Codex configuration
codex mcp add topaimuza-mcp --url https://topaimuza.pl/mcpCursor
Cursor configuration
{
"mcpServers": {
"topaimuza-mcp": {
"url": "https://topaimuza.pl/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"topaimuza-mcp": {
"type": "streamableHttp",
"url": "https://topaimuza.pl/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"topaimuza-mcp": {
"type": "http",
"url": "https://topaimuza.pl/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http topaimuza-mcp https://topaimuza.pl/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"topaimuza-mcp": {
"url": "https://topaimuza.pl/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"topaimuza-mcp": {
"serverUrl": "https://topaimuza.pl/mcp"
}
}
}Let your agent find its tools
Find servers like TopAIMuza MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run TopAIMuza MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.