fullmetrixDocs

MCP server

Connect Claude, ChatGPT or another compatible AI assistant to your Fullmetrix data and query your store from the assistant you already use.

The Fullmetrix MCP server lets your usual AI assistant, such as Claude or ChatGPT, read your Fullmetrix data. Once connected, you ask your questions in Claude or ChatGPT, for example "Which products sold best in September?", and the assistant fetches the answer from your figures.

MCP stands for Model Context Protocol. It is an open standard that defines how an AI assistant plugs into a data source. Any MCP-compatible assistant can therefore connect to Fullmetrix the same way.

Access is read-only. The assistant can read your data, it cannot change anything in Fullmetrix, in your store or in your ad accounts.

Prefer to stay in Fullmetrix?

The AI assistant built into Fullmetrix does the same job without leaving the app, and adds charts and shareable reports. The MCP server is for when you want to work from the assistant you already use.

The server address

Every client uses the same address.

https://app.fullmetrix.com/api/mcp

The server runs over HTTP, in the mode MCP clients call "Streamable HTTP". There are two ways to connect.

  • With your Fullmetrix account. The client sends you to a Fullmetrix page where you authorize access. This is the recommended method, with no key to copy.
  • With an API key, for clients that cannot open a sign-in page. See below.

Before you start

You need a Fullmetrix account with at least one organization whose store is connected and synchronized. The assistant reads your organizations' data, so it needs data to read.

MCP access is part of your Fullmetrix subscription, at no extra cost. Using Claude or ChatGPT is still billed by their makers according to your plan with them.

Connect Claude

Open the Fullmetrix listing

Fullmetrix Analytics is published in the Claude directory. Open its page, or look for Fullmetrix in Claude, in the connectors section of your settings.

Add the connector

Click the add button. Claude opens a Fullmetrix page. Sign in if needed, then authorize access as described in the next section.

Ask a question

In a new conversation, check that the Fullmetrix connector is turned on, then ask your question.

Depending on your Claude plan, adding connectors may be limited to some subscriptions or to your team workspace administrator. The address https://app.fullmetrix.com/api/mcp still works as a custom connector if you would rather add it by hand.

Connect ChatGPT

ChatGPT accepts MCP servers as a custom app, also called a connector.

Open the apps settings

In ChatGPT, open settings, then the apps and connectors section. Depending on your plan, adding a custom app first requires turning on developer mode in the advanced settings.

Create the app

Create a new app. Name it Fullmetrix, paste the address https://app.fullmetrix.com/api/mcp and choose OAuth authentication. Confirm.

Authorize access

ChatGPT opens the Fullmetrix page. Sign in if needed, then authorize access.

Use Fullmetrix in a conversation

In a conversation, add the Fullmetrix app from the tools menu, then ask your question.

ChatGPT menus change often. If you cannot find the option, search for "custom connector" or "MCP" in the ChatGPT help.

Connect another MCP client

Cursor, Visual Studio Code, Windsurf and most MCP-compatible tools are set up with the server address. In your tool's MCP configuration file, declare a remote server like this.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp"
    }
  }
}

The exact key names can vary from one tool to another. Check its documentation. On first use, the tool opens the Fullmetrix authorization page in your browser.

Connect with an API key

If your client does not support account sign-in, use an API key. Create it in Settings, API Keys tab, as described in Public API. Then add it to the Authorization header of the client's requests.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fmx_YOUR_KEY"
      }
    }
  }
}

A key gives access to a single organization, the one where you created it. Account sign-in gives access to all your organizations.

The authorization page

When a client connects with your account, Fullmetrix shows the Connect an external application page. If you are not signed in to Fullmetrix, the sign-in page comes first.

The page describes what the application asks for.

  • Read analytics data, meaning view your stores, customers, products, orders, campaigns, costs and connected service data.
  • Access authorized organizations. Only organizations you can already access in Fullmetrix will be available.

A notice reminds you that access is read-only. Click Authorize access to confirm, or Deny to cancel. You are then taken back to your client automatically.

If the message "The authorization could not be completed. Please try again." appears, start the connection again from your client.

Which organizations are available

Account sign-in opens access to the organizations you see in Fullmetrix. These are your company's organizations if you are an administrator, and the ones an administrator gave you access to. The assistant never sees an organization you cannot see yourself. To manage these accesses, see Team and roles.

If you have several organizations, name the store or organization in your question. Otherwise the assistant queries the first one in the list.

The exposed tools

An MCP client discovers tools, meaning actions it can call. Fullmetrix exposes three, all read-only.

ToolWhat it does
describe_dataDescribes the available data and the services connected to your organizations. The assistant calls it before its first question
query_dataReads your store data in Fullmetrix, such as orders, order lines, products, variations, categories, customers, contacts, carts, discount codes, refunds, subscriptions and visitor browsing. It also reads your Fullmetrix account configuration data
platform_queryQueries a connected service, among Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console and Crisp. If you have several accounts on the same service, it queries them all unless you name one

You do not call these tools yourself. You ask a question in plain language, and the assistant picks the tools and the queries.

The figures come from the same data as your reports. For the assistant to match your figures exactly, ask it to apply the rules from your Report settings, for example excluding cancelled orders.

Example questions

  • What was my revenue in September, compared with September last year?
  • What are my 10 best-selling products this quarter, with their revenue?
  • Compare my Meta Ads spend and my sales day by day over the last 30 days.
  • Which Search Console queries bring the most clicks to my product pages?
  • Summarize the requests received on Crisp this week.

Cut off access

For an account connection, remove the Fullmetrix connector in your client's settings, whether Claude, ChatGPT or another.

For an API key connection, open Settings, API Keys tab, and click Revoke next to the key. The client loses access immediately.

Frequently asked questions

On this page