MerchantFlow — Claude Code MCP server for profit analytics
MerchantFlow gives coding agents access to Shopify and WooCommerce financial data for store profit, product costs and ad performance analysis. Ask questions about your business using its actual figures.
claude mcp add --transport http mcp https://merchantflow.ai/api/mcpWhat MerchantFlow does
MerchantFlow combines Shopify or WooCommerce orders with product COGS, shipping and fulfillment charges, payment processing fees, and ad spend from Meta, Google and TikTok. Through an MCP connection, an agent can examine store finances, calculate product profitability and review advertising returns without relying on dashboard screenshots.
Available tools cover P&L reports, product margins, channel performance, missing cost data, customer cohorts, order searches and integration status. The merchantflow-financial-copilot skill guides the agent in selecting the appropriate tool, comparing reporting periods and identifying stale or incomplete records. Store access is read-only.
The MCP endpoint is https://merchantflow.ai/api/mcp, using HTTP and MerchantFlow OAuth. Configure the server in your client and sign in when prompted. Store analytics require an authorised MerchantFlow account. Access can be revoked under MerchantFlow Settings > Developer > MCP.
What it helps with
- compare store P&L across reporting periods
- identify products with negative net profit
- measure ROAS for each advertising channel
- find products missing COGS values
- inspect integrations for sync failures
Example prompts for the agent
- Compare my store's P&L for last month with the month before and explain the main changes.
- Find the products with the highest net profit and flag items that are losing money.
- Break down ROAS by ad channel for this quarter and identify products without cost data.
How to install MerchantFlow
Platform CLI: remote server
claude mcp add --transport http mcp https://merchantflow.ai/api/mcpPlatform CLI: remote server
codex mcp add merchantflow --url https://merchantflow.ai/api/mcpConfig file
{
"mcpServers": {
"merchantflow": {
"url": "https://merchantflow.ai/api/mcp"
}
}
}Config file
{
"servers": {
"merchantflow": {
"type": "http",
"url": "https://merchantflow.ai/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http merchantflow https://merchantflow.ai/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MerchantFlow
How do I install MerchantFlow in Claude Code?
Run claude mcp add --transport http mcp https://merchantflow.ai/api/mcp, followed by claude mcp add --transport http merchantflow https://merchantflow.ai/api/mcp. Then sign in to MerchantFlow when the agent requests authorisation.
What does MerchantFlow do?
It connects an AI agent to Shopify or WooCommerce financial data for P&L reporting, product cost analysis and advertising performance reviews. It also supports order lookups and integration health checks.
Can MerchantFlow modify my store data?
The connection is read-only and limited to the MerchantFlow store you authorise through OAuth. You can revoke access in MerchantFlow Settings > Developer > MCP.
