MCP Server Overview

The GoodMetrics MCP server lets OAuth-capable MCP clients query your GoodMetrics analytics data with natural-language prompts.

It is a remote, read-only server. There is no GoodMetrics CLI or local stdio server to install. Add the hosted endpoint to your client, sign in to GoodMetrics, approve analytics access, and start asking questions.

https://data.goodmetrics.io/mcp

Quickstarts

Choose the quickstart guide for your MCP client:

ChatGPT Create a GoodMetrics app in ChatGPT Developer mode.

Claude Add GoodMetrics as a custom connector in Claude.

Generic MCP Client Connect any browser client that supports remote HTTP MCP servers and OAuth.

What it can do

The MCP server can:

• Find an accessible site by name, domain, alias, or public gmID.
• Answer questions about realtime activity, overview metrics, pages, referrers, trends, etc.
• Describe an endpoint’s supported parameters, filters, response fields, and examples.
• Query reporting endpoints such as audience, acquisition, pages, charts, headers, and custom events.
• Query realtime endpoints such as visitors, pages, referrers, events, locations, browsers, and device types.

How MCP maps to the REST API

The REST API exposes resource paths such as:

GET https://data.goodmetrics.io/{gmID}/events/audience/countries

Your MCP client discovers the server’s tools and selects the appropriate analytics operations for each question. You can ask common questions using a site name or domain and a date-range shortcut, or request more specific filters, comparisons, and breakdowns.

See Capabilities for the kinds of analytics questions the server can answer.