MerchantFlowMerchantFlow Docs
IntegrationsMCP Server

Connect MerchantFlow to Cursor

Step-by-step guide to connecting MerchantFlow to Cursor via MCP. Pipe your ecommerce data alongside your code.

Connect MerchantFlow to Cursor

Cursor is a code editor with a built-in AI assistant. Connecting MerchantFlow lets you ask cross-system questions like "Which products in my Shopify store have margins under 20% and haven't had a commit to their landing page in 30 days?"

Prerequisites

  • Cursor v0.45 or newer
  • MerchantFlow Pro tier subscription

Step 1: Copy the config

  1. Go to Settings → MCP Server in MerchantFlow
  2. Click the Install in Cursor button
  3. Copy the config snippet

Step 2: Open your Cursor MCP config

The config file lives at:

  • macOS/Linux: ~/.cursor/mcp.json
  • Windows: %USERPROFILE%\.cursor\mcp.json

Paste the snippet:

{
  "mcpServers": {
    "merchantflow": {
      "url": "https://mcp.merchantflow.ai/mcp"
    }
  }
}

If you have other MCP servers, add MerchantFlow alongside them in the same mcpServers object.

Step 3: Reload Cursor

Either restart Cursor or run the Cursor: Reload Window command from the command palette (Cmd+Shift+P / Ctrl+Shift+P).

Step 4: Authorize

The first MCP call triggers an OAuth flow - Cursor opens your browser to MerchantFlow. Click Allow access, then come back to Cursor.

Step 5: Try it

In the Cursor chat:

What are my top 5 most profitable products this month?

Cursor will call get_top_products and show you the list with revenue, profit, and margin per product.

Recommended: add the Skill file as a Cursor rule

  1. Download the Skill file for Cursor: https://mcp.merchantflow.ai/api/mcp/skill?format=cursor
  2. Save it as .cursorrules in your project root (or your home directory for global effect)
  3. Cursor automatically reads this file and applies it as a project rule - your AI will now speak ecommerce fluently

Troubleshooting

See the Claude Desktop troubleshooting section - most issues apply identically.