- shopify-partner-agent is a community project (13 GitHub stars, MIT license) with 25 read-only tools, all targeting the Shopify Partner API, not the Admin API.
- get_merchant_health's revenue score saturates at $100 of lifetime revenue — a merchant who paid $101 scores identically to one who paid $50,000 (analytics.py:1598-1608).
- get_churn_risk is a flat point sum (+30/+20/+25/+10) with no weighting, undisclosed in the README (analytics.py:1422-1444).
- The client sleeps 0.3s after every request and paginates with no page cap (client.py:130-132, 156-182), none of it documented in the README.
- Neither of Shopify's first-party MCP surfaces (Dev MCP, Storefront MCP) exposes the Partner API, which is the gap this server fills.
01 What shopify-partner-agent is and who ships it
If you're looking for an MCP server that talks to the Shopify Partner API — not the Admin API, not a storefront — the answer is shopify-partner-agent, a 13-star community project by Rushikesh More, and it's the only one the public record turns up. Its headline "A-F" merchant health grade looks like a Shopify metric but isn't: it's the author's own hard-coded point rubric, and the revenue component of that grade saturates at just $100 of a merchant's lifetime revenue — a merchant who has paid $101 scores the identical 25/25 as one who has paid $50,000 (src/shopify_partner_agent/analytics.py:1598-1608).
shopify-partner-agent is a community-maintained, MIT-licensed MCP server hosted at github.com/rushikeshmore/shopify-partner-agent, with a matching PyPI package (pypi.org/project/shopify-partner-agent/). It is not a first-party Shopify project — its README describes it as an MCP server for Shopify Partner API analytics, covering MRR, churn, retention, merchant health and payout data for Shopify app developers. The default branch's last commit lands on 2026-04-17. Shopify does ship its own first-party MCP surfaces — the shopify.dev Dev MCP and the Storefront MCP — but neither operates the Admin API, and neither exposes the Partner API. Neither touches app-economics data like MRR, churn or payouts, which is the gap shopify-partner-agent fills. Public record and source read on 2026-08-31.
02 Tools it exposes
The server registers 25 tools, all read-only — the published tool list contains no write path. The Merchant Intelligence and Growth & Forecasting groups are not pass-through Partner API reads: they're computed on top of raw transaction and event pulls, per the source read at src/shopify_partner_agent/analytics.py:1585-1645 and analytics.py:1415-1450.
| Tool | What it does | Read/Write |
|---|---|---|
| discover_apps | Lists apps on the Partner account | Read |
| get_app_details | Fetches details for a single app | Read |
| get_app_events | Fetches app event history (installs, uninstalls, etc.) | Read |
| get_transactions | Fetches Partner API transaction records | Read |
| get_merchants | Lists merchants associated with an app | Read |
| get_revenue_summary | Summarizes revenue over a period | Read |
| get_mrr_movement | Reports MRR movement (new, expansion, churn, contraction) | Read |
| get_payout_report | Reports Partner payout data | Read |
| get_plan_performance | Compares performance across pricing plans | Read |
| get_churn_analysis | Aggregates churn across the merchant base | Read |
| get_retention_cohorts | Builds cohort retention curves from transaction history | Read |
| get_customer_ltv | Computes lifetime value per merchant | Read |
| get_churned_merchants | Lists merchants that have churned | Read |
| get_trial_funnel | Reports trial-to-paid funnel conversion | Read |
| get_growth_velocity | Reports growth rate over time | Read |
| get_install_patterns | Reports install behavior patterns | Read |
| get_revenue_forecast | Projects future revenue from historical data | Read |
| get_referral_revenue | Reports revenue attributed to referrals | Read |
| get_credits_adjustments | Reports credits and adjustments applied to accounts | Read |
| get_churn_risk | Scores individual merchants for churn risk | Read |
| get_merchant_health | Grades individual merchants A-F on tenure/revenue/stability/engagement | Read |
| get_merchant_lookup | Looks up a single merchant's record | Read |
| get_business_digest | Produces a summary digest across the business | Read |
| get_revenue_anomalies | Flags anomalous revenue events across apps | Read |
| get_app_comparison | Compares metrics across multiple apps | Read |
03 Install and auth
Transport is stdio. The install command, copied verbatim from the record, is:
uvx shopify-partner-agentAuthentication runs on a Shopify Partner API access token, generated in the Partner Dashboard, which the server uses to call the Partner API on your behalf.
04 What the source shows: hard-coded rubrics behind the analytics tools
The README's framing of the Merchant Intelligence tools is thin. Reading the handlers shows why that matters. In get_merchant_health, the revenue-score bucketing at src/shopify_partner_agent/analytics.py:1598-1608 assigns the full 25 points to any merchant with total revenue above $100, 20 points above $50, 15 above $10, 10 above $0, and 5 otherwise — a curve that flattens completely past $100 of lifetime spend. README:308 discloses only the four category names (Tenure, Revenue, Stability, Engagement, each 0-25) with no threshold and no saturation point.
get_churn_risk works the same way: analytics.py:1422-1444 shows the score is a flat sum of point additions — +30 for any deactivation event, +20 for any reinstall, +25 for a cancellation inside the last 30 days, +10 for one inside the last 90 — with no weighting or calibration behind those numbers. README:309 describes only "5 heuristic signals: deactivations, cancellations, reinstalls, declining charges, inactivity," without the point values that actually drive the score.
Separately, the client itself carries an undisclosed pacing and pagination design. Every Partner API request is followed by a fixed asyncio.sleep(0.3) (src/shopify_partner_agent/client.py:130-132), the 429 handler retries exactly once after a fixed 2-second wait (client.py:110-113), and the cursor-walking loop in _graphql_paginated has no page cap (client.py:156-182). None of this appears in the README. Public record and source read on 2026-08-31.
05 Quirks, gaps and the honest verdict
- Partner API only — it targets the Shopify Partner API, not the Admin API, so it reads app-business metrics (MRR, churn, cohorts, payouts) and cannot touch a merchant's store.
- All 25 tools are read-only — there is no write path in the published tool list, so it can't be used to act on anything it reports.
- Analytics tools are the server's own model, not Shopify's —
get_retention_cohorts,get_revenue_forecast,get_churn_riskandget_merchant_healthare derived computations over raw Partner transactions, not raw Shopify endpoints. - Undisclosed pacing — the fixed 0.3s per-request sleep and uncapped pagination loop mean a multi-month cohort query walks pages serially with no documented ceiling.
Use shopify-partner-agent for read-only Partner-API reporting — MRR, churn, cohorts, payouts — where the Core Data and Revenue Analytics tools are giving you a fairly direct read on Partner transactions. Unless you're relying on the merchant health grade or churn risk score as a source of truth — then treat those two specifically as the author's own hard-coded point rubrics, not Shopify metrics, given the $100 revenue saturation documented at src/shopify_partner_agent/analytics.py:1598-1608.
In short: it's the only Partner API MCP server on the public record, useful for the reporting layer Shopify's own first-party MCP surfaces don't cover, but its two headline "intelligence" scores are simpler and less calibrated than their names suggest.
07 Frequently asked questions
- Is there a first-party Shopify MCP server for the Partner API?
- No. Shopify's own Dev MCP and Storefront MCP are both first-party MCP surfaces, but neither operates the Admin API and neither exposes Partner API data like MRR, churn or payouts.
- Can shopify-partner-agent write to a merchant's store?
- No. It targets the Partner API and every one of its 25 tools is read-only; there is no write path in the published tool list.
- How trustworthy is the merchant health grade?
- It's the author's own hard-coded rubric, not a Shopify metric. Its revenue component saturates at $100 of lifetime revenue, per src/shopify_partner_agent/analytics.py:1598-1608, so it can't distinguish a $101 merchant from a $50,000 one.
- What credentials does shopify-partner-agent need?
- A Shopify Partner API access token, generated in the Partner Dashboard, which the server uses to authenticate its calls to the Partner API.