25 MCP tools · Open source

Your Shopify Partner data,
in Claude.

MCP server that gives Claude full access to your Shopify Partner analytics. MRR, churn, retention cohorts, merchant health, revenue forecasting — everything HeyMantle charges $49–999/mo for, powered by natural language.

Get StartedView on GitHub
claude

> What's my MRR and who churned recently?

Your current MRR is $2,450.00 across 47 active merchants.

3 merchants churned in the last 30 days:

store-abc.myshopify.com — "Not using app now"

demo-shop.myshopify.com — "Hard to set up"

test-co.myshopify.com — No reason provided

Capabilities

Everything you need to monitor
your Shopify apps.

25 MCP tools. Ask Claude anything about your app business.

Core Data

Raw access to your Partner API data

  • discover_apps

    Find all apps in your partner account

  • get_app_details

    App name, API key, GID

  • get_app_events

    Installs, uninstalls, charge events

  • get_transactions

    Revenue transactions with filtering

  • get_merchants

    Active and churned merchant list

Revenue Analytics

MRR, payouts, plan performance

  • get_revenue_summary

    MRR, ARR, growth rate, ARPU

  • get_mrr_movement

    New / expansion / contraction / churn

  • get_payout_report

    Gross, Shopify fees, net payout

  • get_plan_performance

    Revenue per pricing tier

Customer Analytics

Churn, retention, lifetime value

  • get_churn_analysis

    Revenue / logo / sub churn rates

  • get_retention_cohorts

    Monthly revenue retention table

  • get_customer_ltv

    LTV, ARPU, merchant rankings

  • get_churned_merchants

    Uninstall reasons per merchant

Enhanced Analytics

Conversion, risk, health scoring

  • get_trial_funnel

    Install to paid conversion rate

  • get_churn_risk

    Low / medium / high risk scoring

  • get_merchant_health

    A-F health grade per merchant

  • get_business_digest

    Weekly summary with highlights

Full Coverage

Forecasting, patterns, referrals

  • get_revenue_forecast

    Project MRR 3-6 months ahead

  • get_merchant_lookup

    Full timeline for one merchant

  • get_growth_velocity

    Week-over-week trends

  • get_install_patterns

    Best day / time for installs

  • get_referral_revenue

    Track Shopify referral earnings

  • get_credits_adjustments

    Refunds and giveback tracking

Insight

Anomaly detection, app comparison

  • get_revenue_anomalies

    Detect unusual revenue patterns

  • get_app_comparison

    Side-by-side metrics across apps

PartnerAgent vs. the Rest

Everything they charge for, Claude does with natural language. Plus features no dashboard can offer.

FeaturePartnerAgent
Free		HeyMantle
$49-999/mo
MRR / ARR / ARPU✓✓
MRR Movement (new/expansion/churn)✓✓
Revenue Churn / Logo Churn✓✓
Retention Cohorts✓✓
Customer LTV✓✓
Uninstall Reasons✓✓
Plan Performance✓✓
Trial Funnel✓✓
Churn Risk Scoring✓✓
Merchant Health Grade✓—
Revenue Forecast✓—
Growth Velocity✓—
Install Patterns✓—
Merchant Lookup✓✓
Natural Language Queries✓—
Ad-hoc Analysis✓—
Open Source✓—

Setup in 3 Minutes

No account needed. No dashboard to learn. Just Claude + your data.

1

Create API Client

Go to Partners Dashboard → Settings → Partner API clients. Grant 'Manage apps' + 'View financials' permissions.

2

Install & Configure

Clone the repo, set up your credentials, and register with Claude Code.

git clone https://github.com/rushikeshmore/partner-agent
cd partner-agent
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # Add your credentials
3

Ask Claude

Register the MCP server and start asking about your business.

claude mcp add partner-agent .venv/bin/python server.py

# Then in Claude:
> "What's my MRR?"
> "Who churned recently and why?"
> "Show me a full health check of my app business"

FAQ