Metorik supports the Model Context Protocol (MCP), which lets you connect AI assistants like ChatGPT and Claude to your store data. Once connected, you can ask questions, build reports, and get insights about your orders, customers, products, and more—all through natural language.
A Metorik account with analyst, editor, or admin access to at least one store
An account with ChatGPT (Plus/Team/Enterprise) or Claude (Pro/Team/Enterprise)
MCP access enabled for your store (store admins can control this)
MCP connections are tied to your Metorik user account, not to individual stores. When you authorize an AI assistant, you choose which stores it can access. Permissions mirror your existing Metorik access—if you're an admin on one store and an analyst on another, the AI assistant will have the same level of access for each store.
Store admins can disable MCP access for a store entirely. If disabled, no users on that store can connect AI assistants via MCP, but you can still use MCP with other stores where it's enabled.
Start from the Applications page in your Metorik settings, where you can connect ChatGPT or Claude with one click.
Navigate to Settings → Applications. This page shows all connected apps and lets you manage their access.
On the Applications page, click the Connect ChatGPT button. This will redirect you to the Metorik authorization screen.
On the authorization screen, review the permissions and choose your store access:
All stores I can access now and in future – The connection will follow your live analyst, editor, and admin access across all stores automatically.
Only selected stores – Limit the connection to specific stores you choose now.
Click Authorize to complete the connection.
Once authorized, return to ChatGPT and start asking questions about your store. ChatGPT can now access your Metorik data through the MCP connection.
You can also set up ChatGPT manually from within ChatGPT:
Go to ChatGPT Settings, then open Apps.
Open Advanced Settings and enable Developer Mode so you can create a custom MCP app.
Create a new custom app using these details:
Name: Metorik
MCP Server URL: https://app.metorik.com/mcp
Authentication: OAuth
ChatGPT will redirect you to Metorik to authorize access to your stores.
Start from the Applications page in your Metorik settings, where you can connect ChatGPT or Claude with one click.
Navigate to Settings → Applications.
Click the Connect Claude button to start the authorization flow.
Review the permissions and choose your store access preference (all stores or selected stores), then click Authorize.
Return to Claude and begin asking questions about your orders, customers, products, and analytics.
During the preview period, you can also connect Claude manually through the Claude connectors page:
Go to Claude settings and open Connectors.
Click Add custom connector and enter Metorik as the name.
Enter the MCP server URL https://app.metorik.com/mcp and save the connector. Claude will prompt you to authenticate with Metorik.
Beyond ChatGPT and Claude's web interface, you can connect Metorik to other MCP-compatible tools like Claude Code (CLI), OpenAI Codex CLI, and Cursor IDE. These clients require manual configuration using Metorik's MCP server URL.
The Metorik MCP server URL is: https://app.metorik.com/mcp
Run the following command to add Metorik as an MCP server:
codex mcp add metorik --url https://app.metorik.com/mcpThis will open your browser to complete the OAuth authorization with your Metorik account.
Claude Code is Anthropic's command-line tool for Claude. You can add Metorik as an MCP server using the CLI or a JSON config file.
Using the CLI:
claude mcp add --transport http metorik https://app.metorik.com/mcpAfter running this command, open Claude Code and type /mcp. You'll see Metorik listed—select it to start the OAuth flow and authorize with your Metorik account.
Cursor is an AI-powered IDE that supports MCP servers. You can add Metorik in one of two ways:
Ask Cursor to add it – In a chat, ask Cursor to add an MCP server with the URL https://app.metorik.com/mcp
Configure manually – Create or edit .cursor/mcp.json in your project, or ~/.cursor/mcp.json for global access:
{
"mcpServers": {
"metorik": {
"url": "https://app.metorik.com/mcp"
}
}
}After adding Metorik, go to Settings → Tools & MCPs in Cursor and click Connect next to Metorik to complete the OAuth authorization with your Metorik account.
You can view and manage all your connected AI apps from Settings → Applications.
From this page you can:
Edit access – Change which stores the app can access
Revoke – Disconnect the app entirely
Revoking a connection immediately removes the app's access to your Metorik data.
Store admins can control whether MCP is available for their store:
Go to Store Settings for the store.
Find the MCP access for this store setting.
Toggle it to Enabled or Disabled.
When disabled, no users on that store can connect AI apps via MCP. Users can still use MCP with other stores where it's enabled.
Connections use OAuth to securely authenticate your Metorik account
AI assistants only see data from stores you explicitly authorize
Access levels match your existing Metorik permissions (analyst, editor, admin)
You can revoke access at any time from Applications settings
MCP connections are per-user, not per-store. Each team member sets up their own connection and chooses which stores to include.
There's no specific limit on MCP requests from Metorik's side. Metorik has general rate limits, but in practice you'll rarely hit them—each request requires processing time on the AI side, so natural pauses between queries tend to keep you well within bounds.
Keep in mind that using MCP does consume tokens on your AI provider's end. You may be limited by your ChatGPT or Claude plan's message caps or token quotas. Those limits are controlled entirely by your chat provider, not by Metorik.
Metorik's MCP server provides read-only tools for querying store data, reports, and metadata.
Lists the stores the authenticated user can access, including which store is currently selected as the default.
Searches store resources such as customers, orders, subscriptions, products, variations, categories, coupons, and refunds.
Returns paginated store objects for supported resources like orders, customers, and subscriptions, with optional filtering, sorting, and segment support where available.
Returns sales-focused catalog data for products, variations, categories, brands, or coupons over a date range.
Returns time-series sales data for a single product, variation, category, or coupon over a date range.
Returns summary totals for the same datasets used by Metorik's main list and reporting views, such as orders, customers, and subscriptions.
Returns consolidated analytics for multiple report types, including time series, grouped reports, source reports, breakdown reports, custom metrics, and products bought together.
Lists supporting metadata used by the MCP tools, such as available custom metrics, report options, saved segments, and object field definitions.
All MCP tools are read-only and cannot modify store data. If a tool returns a resource_link, meta.resource_link, or meta.report_link, that link points to the matching page or filtered view in Metorik. Some tools support filters, date ranges, sorting, grouping, and saved segments depending on the resource or report type.
Yes. One Metorik user account can have multiple MCP connections active simultaneously—including ChatGPT, Claude, and other MCP clients like Claude Code, OpenAI Codex CLI, and Cursor. Each connection is authorized separately and can have its own store access settings.
This usually means MCP access is disabled for all your stores. Ask a store admin to enable MCP access in Store Settings. You need analyst, editor, or admin access on at least one store with MCP enabled.
You need analyst, editor, or admin access to at least one store with MCP enabled. Contact your store admin to verify your permissions and the store's MCP setting.
Check that the connection is still active in Settings → Applications. If the connection was revoked or you no longer have access to the store, you'll need to re-authorize.
You can still use MCP with other stores where it's enabled, but you won't be able to access the disabled store through AI assistants until MCP is re-enabled.
Metorik API – Build custom integrations with the Metorik API