MerchantFlow MCP Tool Reference
Complete list of the 24 MCP tools MerchantFlow exposes, plus the built-in prompts and resources available to compatible MCP clients.
MerchantFlow MCP Tool Reference
This is the complete v1 tool catalog for MerchantFlow's 24 read-only tools. Each entry shows the tool name, what it does, and an example prompt that will make Claude, Cursor, Windsurf, or another MCP client call it.
Financial tools
get_pnl_summary
Get a full P&L waterfall for a date range with optional period-over-period comparison.
Summarise this week's P&L with comparison to last week.
get_revenue_breakdown
Split revenue by source, channel, or country.
Show me revenue by source for the last 30 days.
get_expenses_breakdown
Break down OPEX/CAPEX by category and vendor.
What did I spend on software in the last month?
get_bank_balance
Current balance, 30/60/90-day burn rate, and projected runway.
What's my bank runway at current burn?
get_mca_status
Active MCA/revenue-based funding agreements and repayment schedule.
How much do I still owe on my MCA, and what's the daily deduction?
get_date_range_summary
High-level rollup of revenue, profit, orders, ad spend, and key metrics for an arbitrary date range.
Give me a quick summary of Q1 2026.
Product intelligence tools
get_top_products
Top N products ranked by revenue, profit, margin, or units.
What are my 10 most profitable products this month?
get_bottom_products
Bottom N products ranked by profit or margin. Supports a minimum-units filter to drop noise.
Which products are losing money after ad spend?
get_product_detail
Full profitability + 90-day trend for a specific product.
Tell me everything about product {id}.
find_cogs_gaps
Products with missing, zero, or stale COGS that are affecting P&L accuracy.
Find any COGS gaps in my catalog.
run_product_viability
Simulate a new product launch: given price, COGS, and ad spend per unit, get contribution margin, break-even ROAS, and a green/amber/red verdict.
I'm thinking of launching a product at $49 with $12 COGS and $8 ad spend per unit. Is it viable?
Ads and marketing tools
get_ad_performance
Per-platform ad performance: spend, ROAS, orders, CAC. Group by platform, campaign, or country.
How are my Meta campaigns doing vs Google this month?
get_channel_roas
Blended MER and per-platform ROAS with optional period comparison.
What's my blended MER across all paid channels this week?
get_attribution_breakdown
Attributed revenue by channel using the tenant's attribution model.
Break down my attributed revenue by channel.
get_unattributed_revenue
Orders where no channel could be attributed, with examples.
How much revenue did I leave unattributed last month?
Customer intelligence tools
get_cohort_analysis
Cohort LTV, repeat purchase rate, or revenue matrix.
Show me LTV by cohort month for the last 6 months.
get_ltv_summary
Average LTV with optional segmentation by channel, first product, or country.
What's my LTV by acquisition channel?
get_cac_payback
Per-channel customer acquisition cost and payback period.
What's my CAC payback on Meta vs Google?
Goals and monitoring tools
get_north_star_status
Current status of all configured North Star KPIs.
How am I tracking against my North Star KPIs this month?
get_anomalies
Recent anomalies detected by MerchantFlow.
What are the top anomalies in my store this week?
get_recent_activity
Chronological feed of syncs, large orders, and integration events.
What happened in my store in the last 24 hours?
Valuation and strategic tools
run_business_valuation
Full SDE-multiple valuation with scorecard, insights, and sensitivity.
Run a business valuation and tell me what's dragging the multiple down.
get_integration_status
Connection status of all integrations.
Which of my integrations haven't synced in the last 24 hours?
Search tools
search_orders
Search orders by date, customer email, order number, or SKU.
Find the last 5 orders from the customer with email [email protected].
Built-in prompts
Compatible MCP clients can also surface these guided prompts:
weekly_briefing
Generate a structured weekly P&L briefing with revenue, profit, top products, ad performance, and recommendations.
find_profit_leaks
Audit COGS coverage, unprofitable products, inflated expense categories, and unattributed ad spend.
product_launch_check
Run a viability simulation for a proposed product price, COGS, and ad spend with a launch recommendation.
month_end_close
Walk through a month-end close checklist covering missing COGS, expenses, integration gaps, and anomalies.
growth_opportunity_scan
Identify products, channels, and customer segments that look ready to scale.
exit_readiness_check
Run a business valuation plus a diligence-style review of COGS coverage, integration coverage, margin trend, and customer concentration.
Resources
Compatible MCP clients can also read these resources:
merchantflow://tenant/summary
Tenant name, platform, currency, timezone, plan, and sync context so the AI can orient itself before calling tools.
merchantflow://integrations/status
Starter integrations-status resource for clients that hydrate context first. For precise live status, get_integration_status remains the authoritative surface.
merchantflow://north-star/definitions
Starter North Star KPI definitions resource for client context hydration. Use the relevant KPI tools for live metric values.
merchantflow://help/tool-guide
Markdown guide that explains what each tool does and when to use it.
Related
Last updated: April 9, 2026