Supermetrics

Pull marketing data from 150+ platforms into one place.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Data Query: Run a data query against a connected marketing platform. Use discovery tools first to get valid values for ds_id, accounts, fields, and settings. Most parameters depend on the source confi
  • Get Async Query Results: Retrieve results from a data_query using its schedule_id. Call immediately after data_query returns. Keep polling until status is 'completed' or failed.
  • Data Source Discovery: Discover available data sources or get a specific source's configuration. Without ds_id: lists all sources with IDs and auth status. With ds_id: returns full config — always cal

What data it sees

Do you need an account

No: the server works without sign-in

Pull marketing data from 150+ platforms into one place. Build cross-channel reports, compare ad spend, and track campaign ROI.

How to connect

How to connect Supermetrics to Claude

The server address to paste into Claude settings:

https://supermetrics.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Supermetrics to ChatGPT

The server address to paste into ChatGPT settings:

https://supermetrics.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Supermetrics to Cursor

The server address to paste into Cursor settings:

https://supermetrics.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (8)

Raw names from tools/list. Only developers need these.

data_queryRun a data query against a connected marketing platform. Use discovery tools first to get valid values for ds_id, accounts, fields, and settings. Most parameters depend on the source configuration from data_source_discovery. Returns a schedule_id — pass to get_async_query_results immediately.
get_async_query_resultsRetrieve results from a data_query using its schedule_id. Call immediately after data_query returns. Keep polling until status is 'completed' or failed.
data_source_discoveryDiscover available data sources or get a specific source's configuration. Without ds_id: lists all sources with IDs and auth status. With ds_id: returns full config — always call with ds_id after picking a source. CONFIG RESPONSE (ds_id provided): - has_account_list: whether accounts_discovery is needed - has_fields: whether field_discovery is needed - has_report_type_selection: whether a report type should be selected - is_date_range_required: whether date range is needed for queries - report_types: available report types with their specific settings - report_types[].is_free_text_account_required: if true, a free-text identifier is needed (e.g. page alias, URL, profile name) — pass as ds_accounts in data_query - common_settings: settings that apply to all queries for this data source - account_labels: how accounts are labeled for this data source
accounts_discoveryDiscover connected accounts for a data source. Only call if data_source_discovery config shows has_account_list=true. RETURNS: account_id, account_name, group_name, ds_user, ds_user_display_name
field_discoveryDiscover available fields (metrics and dimensions) for a data source. Only call if data_source_discovery config shows has_fields=true. If has_report_type_selection=true, each field belongs to one or more report types. All fields in a single data query must share a common report type. RETURNS: metrics, dimensions, monetary_fields, currency_fields. When querying monetary fields, include a currency field to know the currency.
get_todayGet current UTC date and time. Use before data_query with custom date ranges to resolve relative date references (e.g. "last month") into specific dates.
user_infoRetrieve authenticated user information from Supermetrics. USE WHEN: - Need to get user profile information - Want to check team details and permissions - Need to verify license information - Validate authentication and user context PARAMETERS: - None required (uses authentication token) RETURNS: - User profile (name, email, user_id) - Team information (team_id, company_name, etc.) - User permissions within the team - License information (license_id, status, dates, etc.) - Product information (code, title, logo) AUTHENTICATION: - Requires valid user authentication token (starting with 'otok_') - API keys (starting with 'api_') are NOT supported for this endpoint
contact_supermetricsSend product feedback or create a support ticket with Supermetrics. When creating a support ticket, include any information that is relevant for solving it, eg. what was the user intention, which tools were used, what were the relevant trace IDs. Only create a support ticket when explicitly authorized by the user.