English Français العربية

MerchantFlow

Official registry E-commerce

Read-only Shopify and WooCommerce profit analytics: P&L, COGS, product margins, ROAS and LTV.

Source code Website Documentation

What can you do with MerchantFlow?

  • "Summarise last month's P&L and compare it with the month before."
  • "Which five products made the most net profit last month, and which lost money?"
  • "What is my ROAS by channel this quarter, and where should I cut spend?"
  • "How much of my revenue is missing product costs, and which products need them?"
  • "Are any of my integrations out of date or failing to sync?"

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http merchantflow 'https://merchantflow.ai/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "merchantflow": {
            "type": "http",
            "url": "https://merchantflow.ai/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MerchantFlow for Claude
  2. What you can ask
  3. Getting started
  4. Security and privacy
  5. Support
  6. Repository contents

MerchantFlow for Claude

Revenue is easy to see. Profit is not. MerchantFlow joins your Shopify or WooCommerce orders with your product costs (COGS), shipping and 3PL fees, payment fees and Meta, Google and TikTok ad spend. This plugin lets Claude read that data, so you can ask about your store in plain English and get answers built on your real numbers instead of dashboard screenshots.

What you can ask

  • "Summarise last month's P&L and compare it with the month before."
  • "Which five products made the most net profit last month, and which lost money?"
  • "What is my ROAS by channel this quarter, and where should I cut spend?"
  • "How much of my revenue is missing product costs, and which products need them?"
  • "Are any of my integrations out of date or failing to sync?"

Claude picks the right MerchantFlow tool for each question: P&L summaries, product profitability, ad and channel performance, COGS coverage, cohorts, order lookup and integration health. The included merchantflow-financial-copilot skill tells Claude how to route questions, compare periods and flag missing or stale data instead of guessing.

Getting started

  1. Install the MerchantFlow plugin from the Claude plugin directory.
  2. Sign in to MerchantFlow when Claude asks. Don't have an account yet? Start at merchantflow.ai/ai.
  3. Ask a question about your store.

Setup guides for Claude Code, Claude Desktop and other clients are in the MerchantFlow MCP documentation.

Security and privacy

  • The plugin connects to https://merchantflow.ai/api/mcp over HTTP and signs in with MerchantFlow OAuth. No credentials or tokens are stored in this repository.
  • Access is read-only and scoped to the MerchantFlow store you authorise.
  • You can revoke access at any time in MerchantFlow Settings > Developer > MCP.
  • See the privacy policy and terms of service.

Support

Read the troubleshooting guide or email support@merchantflow.ai.

Repository contents

  • .claude-plugin/plugin.json - plugin metadata and directory listing details.
  • .mcp.json - the MerchantFlow MCP connection.
  • skills/merchantflow-financial-copilot/ - tool routing and reporting guidance.
  • assets/logo-icon.png - MerchantFlow brand mark.

This repository contains no MerchantFlow application source code, customer data, credentials or access tokens.

Frequently asked questions

What is MerchantFlow?

Read-only Shopify and WooCommerce profit analytics: P&L, COGS, product margins, ROAS and LTV.

How do I install MerchantFlow?

It runs as a remote server. In Claude Code: claude mcp add --transport http merchantflow 'https://merchantflow.ai/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MerchantFlow need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is MerchantFlow open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains MerchantFlow?

It is published by MerchantFlow. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.