Connect AI Tools (MCP)

Ask your AI assistant questions about Chartmetric endpoints and get answers grounded in these docs — without scrolling the API reference. Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

New here? The Quickstart is the fastest way in. Bookmark this page — it's where you'll come when you want to plug Chartmetric into your AI tools.

What this gives you

The MCP server turns these docs into a tool your assistant can call. Without it, you scroll the API Reference looking for the right endpoint. With it, you ask:

"Which artist endpoint returns Spotify monthly listeners?"

…and the assistant searches the docs and answers with links.

Endpoint: https://apidocs.chartmetric.com/mcp (HTTP transport)
No setup auth. The docs are public — connect before you even have an API token.
Different purpose from the API itself. MCP helps you understand and discover endpoints. Running actual API requests still goes through api.chartmetric.com with an access token — see Authentication.

Install

Claude Code

claude mcp add --transport http scalar-docs https://apidocs.chartmetric.com/mcp

--transport http is required. Without it, the connection fails.

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "scalar-docs": {
      "type": "http",
      "url": "https://apidocs.chartmetric.com/mcp"
    }
  }
}

Restart Claude Desktop.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "scalar-docs": {
      "url": "https://apidocs.chartmetric.com/mcp"
    }
  }
}

Other clients

Windsurf, Cline, and custom MCP clients: point the client at https://apidocs.chartmetric.com/mcp with HTTP transport.

Use

Ask natural-language questions about the API. Examples:

"Which endpoint returns an artist's followers across all DSPs?"
"What query parameters does the playlist tracks endpoint accept?"
"Show the response schema for /api/artist/:id/tracks."
"How do I paginate through chart results?"

The assistant searches these docs and replies with links back to this site.

Without MCP: `llms.txt`

For tools that don't speak MCP, two static bundles are served at the site root:

/llms.txt — index of all pages (small, fits in any context window).
/llms-full.txt — full content of every page concatenated.

Drop either into a system prompt or upload as a file attachment. Both are regenerated weekly from the live OpenAPI spec.