# MerchantFlow

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: MerchantFlow
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MerchantFlow/merchantflow-claude-plugin
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/merchantflow

## What it 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.

## Requirements
- Remote server: `https://merchantflow.ai/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://merchantflow.ai/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add merchantflow --url https://merchantflow.ai/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "merchantflow": {
            "url": "https://merchantflow.ai/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "merchantflow": {
            "type": "http",
            "url": "https://merchantflow.ai/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http merchantflow https://merchantflow.ai/api/mcp
```

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md