FERMÀT MCP lets you connect your FERMÀT account to AI tools like Claude, ChatGPT, or any MCP-compatible client — so you can ask questions about your store's performance, ad data, funnels, and more without ever logging into a dashboard.
What's in this guide:
Overview
FERMÀT MCP (Model Context Protocol) is a server that bridges your FERMÀT commerce data with the AI tools you already use. Instead of exporting CSVs or switching between dashboards, you can simply ask your AI assistant a question — and get real-time answers pulled directly from your FERMÀT account.
MCP works with Claude Desktop, Claude.ai, Claude Code, ChatGPT (Plus+), and any MCP-compatible tool.
Pro tip: Start a new conversation and try — "What was my ROAS across Meta last week?"
What You Get
Once connected, you can access the following directly from your AI assistant:
Ad performance across Meta, TikTok & Google — ROAS, CPA, spend, clicks
Funnel metrics — sessions, conversions, revenue, CVR, AOV
Product catalog & variant-level performance
Destination insights — per-channel ROAS, revenue, attribution
A/B experiment results with statistical significance
Session behavioral insights & heatmaps — rage clicks, dead clicks, scroll depth
Anomaly detection with root-cause analysis
Friction point analysis — automated UX issue detection
Pierre — FERMÀT's built-in AI analyst. Try: "What's my biggest growth opportunity?" or "Give me a weekly performance summary"
How to Get Started
Setup takes less than 2 minutes:
Step 1: Go to the MCP Server Page
Navigate to mcp.fermatcommerce.com/mcp/fermat-mcp
You'll see the FERMÀT Platform MCP Server page with installation options for multiple AI clients.
Step 2: Click "Add to Client"
Click the "Add to Client" button at the top-right of the page. You'll see a dropdown with the following supported clients:
Cursor
Claude Code
Claude Desktop
VS Code
Gemini CLI
Codex CLI
Select the AI tool you want to connect.
Step 3: Follow the Setup Instructions
After selecting your client, a popup will show step-by-step instructions specific to that tool. For example, for Claude Desktop:
Navigate to Settings > Connectors
Click "Add custom connector"
Enter the MCP server URL:
https://mcp.fermatcommerce.com/mcp/fermat-mcpClick "Add" to finish configuring
Step 4: Authenticate
When prompted, sign in with your existing FERMÀT platform credentials. Authentication uses Auth0 PKCE OAuth — secure, scoped per-brand, and HTTPS-encrypted.
Step 5: Start Asking Questions
That's it — you're connected. Open a new conversation in your AI tool and start querying your FERMÀT data.
Note: If you prefer manual configuration, the MCP server page also provides the raw JSON configuration and server URL endpoint at the bottom of the page. Copy and paste into your client's MCP settings.
For Teams & Enterprise: Admins can add this as a managed connector for their organization from the Admin Dashboard > Connectors page. Once added, team members can connect from Settings > Connectors.
What You Can Ask
Here are example prompts organized by category to help you get started:
Ad Performance
"What's my ROAS by campaign on Meta this month?"
"Which ads have the highest CPA?"
Funnel Analytics
"What's my conversion rate across all funnels this week?"
"Compare funnel performance month-over-month"
Product Data
"Which product variants had the most add-to-carts?"
"Show me my best-selling SKUs"
Experiments
"What are my live A/B test results?"
"Which variant is winning my homepage test?"
Session Insights
"Are there rage clicks on my funnels?"
"Where are customers dropping off in checkout?"
Destinations
"Which channels are driving the best ROAS?"
"Break down revenue by destination"
Anomaly Detection
"Any anomalies in my funnel performance this week?"
Available Tool Modules
The FERMÀT MCP server includes 12 tool modules, each covering a different area of your commerce data:
Product Catalog — Search products, view details, variant-level data
Funnel Analytics — Sessions, conversions, revenue, CVR, AOV with date ranges
Ad Performance — Per-ad metrics: spend, clicks, ROAS, CPA across channels
Destination Insights — ROAS, revenue, attribution per destination per channel
Experiments — A/B tests, routing splits, product group experiments
Session & Behavioral — Behavioral patterns, heatmaps, intention scoring
Anomaly & Friction — Auto-detected anomalies and UX friction points
Branding — Brand colors, fonts, button styles, brand voice
Offers — Discount offers, tiers, code configurations
Bundles — Bundle configurations, products, pricing
Product Pages — PDP versions, layouts, configurations
Pierre AI — Natural language BI agent — ask Pierre strategic questions
FAQ
Do I need a FERMÀT account?
Do I need a FERMÀT account?
Yes. The MCP authenticates with your existing FERMÀT platform credentials. Contact your FERMÀT account team if you don't have access yet.
Is my data secure?
Is my data secure?
Absolutely. Authentication uses Auth0 PKCE OAuth, scoped per-brand, and fully HTTPS-encrypted. External access is read-only — no one can modify your store through the MCP.
Can I edit my funnels through the MCP?
Can I edit my funnels through the MCP?
Not yet. External access is currently read-only. Write capabilities are coming soon.
Which AI tools are supported?
Which AI tools are supported?
Claude Desktop, Claude.ai, Claude Code, ChatGPT (Plus+), Cursor, VS Code, Gemini CLI, Codex CLI, and any MCP-compatible tool.
How current is the data?
How current is the data?
Real-time from your FERMÀT account. Analytics sync from GA4 and ad platforms at their standard intervals.
What if I use multiple brands?
What if I use multiple brands?
The MCP connection is scoped per-brand based on your authentication. You'll see data for the brand associated with your login credentials.