MCP tools, access, and rate limits

artist.tools exposes 41 MCP tools to connected clients, grouped into Research, Workspace, and Admin. The full registry holds 41 tools: 33 normal tools plus 8 administrator-only tools. Most tools require Developer Access, and rate limits apply per account and per tool group.

Tool catalog

The catalog is searchable in the Developer Console MCP tab. Tools that write data are marked Write, and tools that delete data are marked Deletes data.

Research

Research tools search and inspect Spotify entities, SEO data, and press and playlist signals.

  • who_am_i

  • resolve_entity

  • search_artists

  • search_tracks

  • search_playlists

  • search_curators

  • get_entity

  • get_track_credits

  • get_keyword

  • search_keywords

  • get_google_rankings

  • get_press_mentions

  • get_playlist_spotify_rankings

  • get_entity_activity

  • get_artist_discography

  • get_playlist_discovered_on

  • get_spotify_autocomplete_suggestions

  • search_documentation

Workspace

Workspace tools manage your saved folders, saved keywords, and entity notes.

  • list_entity_notes

  • list_entity_folders

  • create_entity_folder

  • rename_entity_folder

  • delete_entity_folder

  • add_entity_to_folder

  • remove_entity_from_folder

  • set_entity_note

  • list_keyword_folders

  • create_keyword_folder

  • rename_keyword_folder

  • delete_keyword_folder

  • add_keyword_to_folder

  • remove_keyword_from_folder

  • set_keyword_saved

Admin

Admin tools support administrator operations and are available only to administrators who approve them.

  • admin_get_user

  • admin_get_playlist_quality_report

  • admin_set_playlist_quality_override

  • admin_set_ai_content_status

  • admin_update_contact_info

  • admin_clear_contact_fields

  • admin_refresh_entity

  • admin_refresh_curator_playlists

Access requirements

  • Normal research and workspace tools require Developer Access.

  • The who_am_i and search_documentation tools are available on all plans.

  • Users on other plans can connect but can't run tools yet.

  • Admin tools require an administrator account and explicit administrator approval on the connection.

Rate limits

Rate limits apply per account and per tool group. Each successful call consumes the global minute and daily buckets plus the selected tool group's minute and daily buckets.

Tool group

Per minute

Per day

Search

60

5,000

Workspace reads

60

5,000

Workspace writes

30

1,000

Entity reads

20

1,000

Track credits

5

250

Provider enrichment

2

100

Deep enrichment

2

10

Admin reads

30

1,000

Admin writes

10

250

get_playlist_spotify_rankings uses the Search limits normally and the Provider enrichment limits when you call it with refresh=true. A refresh requires a single exact_keyword and a market; bulk ranking refreshes are not allowed.

Separately, the server enforces global limits of 120 requests per minute, 10,000 requests per day, and four concurrent tool calls. These global limits are enforced but not shown in the catalog UI.

Was this helpful?