Connect Supermetrics to Claude Code

Query marketing and ads data from 150+ platforms. Google Ads, Meta, GA4, LinkedIn and more, through one API. Add Toolspoke to Claude Code once and it can use 5 Supermetrics actions. Your Supermetrics credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Supermetrics and connect it

    Add Supermetrics to a project in your Toolspoke workspace.

    API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    API key
    Supermetrics Hub (hub.supermetrics.com) → your avatar → API keys → Create API key. Only team admins and owners can create one. The key queries every data source login your team has connected.
  3. Choose what Claude Code may do

    All 5 actions only read, and any of them can be switched off for a project.

What you can ask Claude Code for

A few of the Supermetrics actions that only read, so they are safe to try first.

  • Run one query against a data source and return the rows as JSON
  • The dimensions and metrics one data source offers, with the field ids query_data takes
  • The status of a query that returned a schedule_id
  • Page through the rows of a finished query by schedule_id

What Claude Code can do in Supermetrics

5 actions read.

Reads

  • Query data

    Run one query against a data source and return the rows as JSON. Name the source with ds_id (AW Google Ads, FA Meta Ads, GAWA Google Analytics 4, LIA LinkedIn Ads, …), the accounts with ds_accounts (from list_accounts), and the columns with fields (from list_fields, dimensions first). Check meta.status_code in the answer: SUCCESS means the rows are there; a still-running query returns a schedule_id for get_query_status.

  • List accounts

    The accounts available in one data source through the team's connected logins, the ids query_data takes as ds_accounts.

  • List fields

    The dimensions and metrics one data source offers, with the field ids query_data takes. An install tests itself with it against Google Analytics 4, because it needs the key to be valid and allowed to query but does not depend on which sources the team has connected.

  • Get query status

    The status of a query that returned a schedule_id. SCHEDULED, QUEUED, RUNNING, SUCCESS, FAILURE or STOPPED, with its rows once it has finished. Results expire an hour after the query stops.

  • Get query results

    Page through the rows of a finished query by schedule_id.

Supermetrics in Claude Code: questions

Does Claude Code see my Supermetrics credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Will 5 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Supermetrics action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Supermetrics call does not run in a sandbox, so it bills nothing.

Try Supermetrics in Claude Code

Free to start, and tool calls cost nothing on any plan.