Discover all Shopify apps in your partner account.

Checks configured app IDs from .env AND scans recent transactions for additional apps. Returns app GIDs and names -- use these IDs for all other tools.

Returns: JSON string with keys: apps (list of id/name dicts), count.

Get details for a specific Shopify app.

Args: app_id: App GID (e.g., 'gid://partners/App/1234') or numeric ID.

Returns: JSON string with app name, API key, and GID.

Get app events (installs, uninstalls, charges, etc.) for a specific app.

Args: app_id: App GID or numeric ID (required). event_types: Comma-separated filter. Available types: RELATIONSHIP_INSTALLED, RELATIONSHIP_UNINSTALLED, RELATIONSHIP_DEACTIVATED, RELATIONSHIP_REACTIVATED, SUBSCRIPTION_CHARGE_ACCEPTED, SUBSCRIPTION_CHARGE_ACTIVATED, SUBSCRIPTION_CHARGE_CANCELED, SUBSCRIPTION_CHARGE_DECLINED, ONE_TIME_CHARGE_ACCEPTED, ONE_TIME_CHARGE_DECLINED, CREDIT_APPLIED, CREDIT_PENDING, CREDIT_FAILED date_from: Start date (YYYY-MM-DD format, optional). date_to: End date (YYYY-MM-DD format, optional). limit: Max events to return (default 100).

Returns: JSON string with keys: events (list with type, shop, date), count, app_id.

Get revenue transactions from your Shopify Partner account.

Args: app_id: Filter by specific app (optional). date_from: Start date YYYY-MM-DD (optional). date_to: End date YYYY-MM-DD (optional). transaction_types: Comma-separated filter. Types: APP_SUBSCRIPTION_SALE, APP_USAGE_SALE, APP_ONE_TIME_SALE, APP_SALE_ADJUSTMENT, APP_SALE_CREDIT, SERVICE_SALE, REFERRAL_TRANSACTION limit: Max transactions (default 100).

Returns: JSON string with keys: transactions (list with type, amount, app, shop, date), count.

List merchants (stores) using a specific app.

Args: app_id: App GID or numeric ID (required). status: 'active' (current installs), 'churned' (uninstalled), or 'all' (both). Default 'active'.

Derived from app events.

Returns: JSON string with keys: merchants (list with shop, status, dates, reasons), count, summary.

Get revenue analytics: MRR, ARR, total revenue, growth rate, ARPU.

Args: app_id: Filter by app (optional, defaults to all apps). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with MRR, ARR, total net revenue, Shopify fees, growth rate vs. previous period, ARPU, and breakdown by app and currency.

Get MRR movement breakdown: new, expansion, contraction, churn, reactivation.

Args: app_id: Filter by app (optional). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Shows how MRR changed between current and previous period.

Returns: JSON string with new, expansion, contraction, churn, reactivation MRR values and net new MRR.

Get payout summary: gross revenue, Shopify fees, net payout.

Args: app_id: Filter by app (optional). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with gross, fees, net totals and per-type breakdown. Note: amounts are for analytics, not accounting.

Get metrics per pricing plan tier.

Args: app_id: Filter by app (optional). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with subscribers, total revenue, avg revenue per merchant for each inferred pricing tier.

Get churn metrics: revenue churn %, logo churn %, uninstall reasons.

Args: app_id: App GID or numeric ID (required). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with logo_churn, revenue_churn, and uninstall_reasons breakdown.

Get monthly revenue retention cohort table.

Args: app_id: Filter by app (optional). months: How many months to track per cohort (default 12).

Returns: JSON string with monthly cohort table showing revenue retention percentages. Values above 100% indicate expansion.

Get customer lifetime value (LTV), ARPU, and merchant rankings.

Args: app_id: Filter by app (optional).

Returns: JSON string with LTV, ARPU, average lifespan, and top/bottom 5 merchants by total revenue.

Get recently churned merchants with uninstall reasons.

Args: app_id: App GID or numeric ID (required). days: Look back period in days (default 30).

Returns: JSON string with churned merchant list including shop name, domain, uninstall date, and reason. Sorted most recent first.

Detect unusual patterns in revenue.

Args: app_id: Filter by app (optional). lookback_days: Analysis window in days (default 90).

Returns: JSON string with anomaly list (date, amount, expected, deviation, type). Empty list if no unusual patterns found.

Compare metrics across all your Shopify apps side by side.

Args: period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with per-app comparison including revenue, installs, uninstalls, churn rate, and LTV.

Score active merchants by churn risk (low/medium/high).

Args: app_id: App GID or numeric ID (required).

Heuristic signals: deactivation events, subscription cancellations, reinstall patterns, declining charges, long inactivity.

Returns: JSON string with risk summary and merchant lists grouped by risk level (high/medium/low) with contributing factors.

Score merchants with a composite health grade (A-F).

Args: app_id: App GID or numeric ID (required).

Grades based on 4 dimensions (0-25 each, total 0-100):

• Tenure: how long installed

• Revenue: total and recent charges

• Stability: no deactivations/reinstalls

• Engagement: recent activity

A (85+), B (70-84), C (55-69), D (40-54), F (<40).

Returns: JSON string with grade distribution summary and per-merchant health scores with dimensional breakdown.

Get a business digest with key metrics and highlights.

Args: app_id: App GID or numeric ID (required). period: '7d' (weekly), '30d' (monthly), or custom range.

Returns: JSON string with period summary, comparison to previous period, highlights, new installs, and recent churns.

Get full timeline for a specific merchant.

Args: app_id: App GID or numeric ID (required). shop_domain: The merchant's myshopify.com domain (required). Example: 'my-store.myshopify.com'

Returns: JSON string with merchant status, revenue total, and full chronological timeline of events and transactions.

Get trial-to-paid conversion funnel.

Args: app_id: App GID or numeric ID (required). period: '7d', '30d', '90d', '1y', or 'YYYY-MM-DD:YYYY-MM-DD'.

Returns: JSON string with conversion funnel metrics, timing analysis, and lists of converted/unconverted merchants.

Project future MRR for the next 3-6 months.

Args: app_id: Filter by app (optional). forecast_months: How many months to project (default 6).

Returns: JSON string with current MRR, growth rate, historical data, monthly projections, and projected ARR.

Get week-over-week growth trends with acceleration signals.

Args: app_id: App GID or numeric ID (required). weeks: Number of weeks to analyze (default 12).

Returns: JSON string with weekly install/uninstall/revenue data and acceleration/deceleration signals.

Analyze install patterns by day of week and time of month.

Args: app_id: App GID or numeric ID (required).

Returns: JSON string with install counts by day of week, month period, monthly trend, and best day for installs.

Track referral revenue from merchant referrals to Shopify.

Args: period: '7d', '30d', '90d', '1y', or custom range.

Returns: JSON string with total referral revenue, count, previous period comparison, and individual referral details.

Track credits, adjustments, and refunds.

Args: app_id: Filter by app (optional). period: '7d', '30d', '90d', '1y', or custom range.

Returns: JSON string with credit/adjustment totals, giveback percentage, and individual transaction details.