Skip to content

Supersimple MCP server

Supersimple exposes its AI as a Model Context Protocol (MCP) server, so you can ask analytics questions about your data straight from Claude, Cursor, or any other MCP-capable AI assistant. You get the same answer you'd get inside Supersimple – a written explanation, and (where the assistant supports it) an interactive chart – without leaving the tool you're already in.

Looking to go the other way, and let Supersimple's AI use your MCP servers as a data source? That's the Custom MCP integration instead.

Connection details

Any MCP client needs just two things:

  • Server URLhttps://app.supersimple.io/mcp
  • Authorization headerAuthorization: Token <your-token>

The transport is streamable HTTP.

Get an API token

Head to Account settings → Developers and generate an API token. The token is tied to your own user, so the AI answers with exactly your access (see Permissions below). Treat it like a password.

Setup

sh
claude mcp add --transport http supersimple https://app.supersimple.io/mcp \
  --header "Authorization: Token YOUR_TOKEN"

Once it's connected, your assistant gains an Ask Supersimple tool. Just ask in plain language and it calls Supersimple for you:

Ask Supersimple which customers churned last month and why.

Ask the way you'd ask a colleague – Supersimple resolves the field names, metrics, time ranges and grouping itself from your data model, so you don't need to spell out columns or SQL.

Permissions

Supersimple answers using the permissions of the token's owner, so you only ever see data you already have access to – across every connected data source, not just one. Because the token carries your identity, two people asking the same question may get different results, and anyone holding your token can query with your access. Keep it private, and revoke it anytime from Account settings → Developers.