partnerlens-mcp
OfficialProvides tools for searching Shopify apps, retrieving app details and reviews, analyzing review sentiment and pain points, comparing apps, listing categories, and getting top-ranked apps. With a paid plan, also accesses private app metrics like installs, uninstalls, and revenue.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@partnerlens-mcp Who are the top 10 apps in email-marketing right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
partnerlens-mcp
MCP server for Shopify App Store intelligence — give Claude, Cursor, or any MCP client access to 17,000+ Shopify apps, 829,000+ reviews, category rankings, and AI-analyzed review sentiment, powered by the PartnerLens dataset.
Ask things like:
"What are merchants complaining about in Klaviyo's 1-star reviews this year?"
"Compare Judge.me, Loox, and Yotpo on rating trend and top pain points."
"Who are the top 10 apps in email-marketing right now?"
"Find underserved pain points in the upsell category I could build an app for."
"Did my uninstalls spike last month, and what are competitors' users complaining about?" (paid plan)
Quick start
1. Get a free API key — sign up at partnerlens.app,
then Settings → API Keys → New Key (keys look like as_…).
2. Add the server to your client:
Claude Code
claude mcp add partnerlens -e PARTNERLENS_API_KEY=as_your_key -- npx -y partnerlens-mcpClaude Desktop / Cursor (mcpServers JSON)
{
"mcpServers": {
"partnerlens": {
"command": "npx",
"args": ["-y", "partnerlens-mcp"],
"env": { "PARTNERLENS_API_KEY": "as_your_key" }
}
}
}Related MCP server: Store Scraper MCP
Tools
Tool | What it does |
| Search apps by name, developer, or slug |
| Full app detail: rating, categories, Built-for-Shopify, latest rank |
| Individual reviews, newest first, filterable by star rating |
| Rating distribution, sentiment, 12-month velocity, top pain points |
| 2–5 apps side by side with review summaries |
| All App Store categories with app counts |
| Current top-ranked apps in a category |
Your own data (Unlimited plan)
With a PartnerLens Unlimited plan and the Shopify Partner integration connected (Settings → Integrations), two more tools unlock your private Partner Dashboard data:
Tool | What it does |
| Your apps synced from your Shopify Partner organization |
| Your daily installs, uninstalls, active shops, revenue, MRR + movements, churn |
So Claude can answer things like "did my uninstalls spike after the price change, and how does my rating trend compare to my top competitor's?" — your data and market data in one conversation. Free keys get a clear message explaining the requirement; the public tools above work for everyone.
Hosted / HTTP mode
The same binary serves stateless Streamable HTTP for remote deployment:
partnerlens-mcp --http --port 3333
# endpoint: http://localhost:3333/mcpIn HTTP mode each request's Authorization: Bearer as_… header is forwarded to
the PartnerLens API — the server stores nothing and keeps no sessions.
Environment
Variable | Purpose |
| Required in stdio mode. Free at partnerlens.app |
| Override API base (default |
| HTTP port when |
Rate limits (free tier)
60 requests/minute and 1,000 requests/day per key. Responses carry
X-RateLimit-* headers. Need more? Talk to us.
Development
pnpm install
pnpm test # vitest
pnpm typecheck
pnpm build # tsup → dist/PRs welcome — tools live in src/tools.ts as plain data and are unit-tested without a transport.
License
MIT
Available Tools
9 toolscompare_appsA
Compare 2-5 Shopify apps side by side: metadata plus each app’s aggregate review summary. Ideal for competitor analysis.
Inputs: slugs (required).
get_appA
Get full details for one Shopify app by slug: description, developer, rating, review count, categories, Built-for-Shopify status, launch date, and its latest rank in its primary category.
Inputs: slug (required).
get_app_reviewsA
Read individual reviews for a Shopify app, newest first. Optionally filter by star rating (e.g. rating=1 surfaces complaints and churn reasons; rating=5 surfaces what users love). Paged.
Inputs: slug (required), rating, page, per_page.
get_my_appsA
List YOUR OWN apps synced from your Shopify Partner organization (name, handle, partner app id). Requires a PartnerLens Unlimited plan and the Shopify Partner integration connected in Settings → Integrations. Returns an empty list until the integration has synced. Use the returned id with get_my_metrics.
Inputs: no named parameters.
get_my_metricsA
YOUR OWN private daily Partner Dashboard metrics: installs, uninstalls, active shops, gross/net revenue, MRR with movement breakdown (new/expansion/contraction/churned), and churn rate. Defaults to the last 30 days (max 366). Requires a PartnerLens Unlimited plan with the Shopify Partner integration connected. Combine with public tools to compare your performance against competitors.
Inputs: app, from, to.
get_review_summaryA
Aggregate review intelligence for a Shopify app: rating distribution, sentiment breakdown (positive/negative/neutral), review velocity per month for the last 12 months, and the top AI-extracted pain points. Much cheaper than reading raw reviews — start here for app health.
Inputs: slug (required).
get_top_appsA
Current top-ranked apps in a Shopify App Store category, from the latest scrape. Returns position, app metadata, rating, and review count.
Inputs: category (required), limit.
list_categoriesA
List all Shopify App Store categories with app counts, largest first. Use the returned slugs with get_top_apps.
Inputs: no named parameters.
search_appsA
Search the Shopify App Store dataset (17k+ apps) by app name, developer name, or slug. Returns matching apps with rating, review count, and categories. Use this first to resolve an app name to its slug.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct operation: comparing apps, fetching details, reviews, summaries, searching, listing categories, top apps, and private metrics. No overlap.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_app, list_categories, search_apps), making it easy for agents to infer functionality.
Nine tools cover the domain of Shopify app analytics and partner metrics comprehensively without unnecessary bloat or missing essentials.
The set provides full lifecycle coverage: discovery (search, categories, top apps), detailed info (get_app), reviews (get_app_reviews, get_review_summary), comparison (compare_apps), and partner private metrics (get_my_apps, get_my_metrics). No obvious gaps.
Maintenance
Related MCP Connectors
Shopify App Store intelligence: keyword ranks, competitors, reviews, revenue. Free tier.
Read-only analytics for your Shopify apps: MRR, churn, uninstall reasons, App Store rank, reviews.
App Store keyword rankings, competitors, markets, reviews and analytics for iOS apps, from your AI.
Scrape Shopify App Store apps, full review histories and catalog. E-commerce market research.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to Astro's App Store Optimization (ASO) database for analyzing app rankings, keyword trends, historical performance data, and app ratings. Provides comprehensive tools for tracking and comparing app store performance metrics through natural language queries.33 npm34MIT
- AlicenseCqualityDmaintenanceEnables querying and retrieving data from App Store and Google Play Store, including app details, reviews, ratings, rankings, permissions, and search capabilities across both iOS and Android platforms.20MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn app intelligence query engine that enables analysis of over 1 billion reviews from Google Play and the Apple App Store. It provides tools for sentiment analysis, keyword rankings, competitive comparisons, and time-series forecasting across 250,000+ apps.16 npm2-
- AlicenseNot gradedqualityDmaintenanceProvides live App Store rankings, charts, app details, reviews, and search across 55 countries, enabling AI assistants to query app store data.17 npm1MIT