Skip to main content
Glama

Chart Top Artists

chart_top_artists
Read-onlyIdempotent

The world's most-popular music right now — global top artists by listener count. PREFER for "recommend popular music", "top songs / top artists this year", "what music is trending", "popular songs 2026" and any general most-popular-music question (for a GENRE use tag_top_artists; for one NAMED user's history use the user_* tools). Keyless, returns ranked artist names with listener and play counts.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
artistsNoGlobal top artists container

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "limit": 50
      +  }
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "artists": {
      +      "description": "Global top artists container",
      +      "properties": {
      +        "@attr": {
      +          "properties": {
      +            "page": {
      +              "type": "string"
      +            },
      +            "perPage": {
      +              "type": "string"
      +            },
      +            "total": {
      +              "type": "string"
      +            },
      +            "totalPages": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "artist": {
      +          "description": "Array of global top artists",
      +          "items": {
      +            "properties": {
      +              "image": {
      +                "items": {
      +                  "properties": {
      +                    "#text": {
      +                      "type": "string"
      +                    },
      +                    "size": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "listeners": {
      +                "description": "Number of listeners",
      +                "type": "string"
      +              },
      +              "name": {
      +                "description": "Artist name",
      +                "type": "string"
      +              },
      +              "playcount": {
      +                "description": "Global play count",
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Artist URL",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, open-world, idempotent, non-destructive. The description adds behavioral context: returns ranked artist names with listener and play counts, and notes keyless access. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences front-load the core purpose and immediately provide usage guidance and exclusions. No filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read-only tool with output schema, the description covers purpose, usage, and output format. Minor gap is limit parameter semantics, but that is already handled in parameter dimension.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has only 'limit' with no description (0% coverage). The description does not mention the limit parameter, its default, or allowed values, leaving the agent to infer its semantics solely from the property name and example.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool provides global top artists by listener count, using 'world's most-popular music right now' and explicitly contrasts with tag_top_artists for genre and user_* tools for named user histories. This distinguishes it from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit PREFER list with example queries and exclusions for genre and user-specific cases. Also notes keyless operation, which helps the agent know there are no auth prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.