Skip to main content
Glama

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-mcp

Claude 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

Search apps by name, developer, or slug

get_app

Full app detail: rating, categories, Built-for-Shopify, latest rank

get_app_reviews

Individual reviews, newest first, filterable by star rating

get_review_summary

Rating distribution, sentiment, 12-month velocity, top pain points

compare_apps

2–5 apps side by side with review summaries

list_categories

All App Store categories with app counts

get_top_apps

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

get_my_apps

Your apps synced from your Shopify Partner organization

get_my_metrics

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/mcp

In 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

PARTNERLENS_API_KEY

Required in stdio mode. Free at partnerlens.app

PARTNERLENS_API_URL

Override API base (default https://www.partnerlens.app/api/v1)

PORT

HTTP port when --port isn't passed

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 tools
compare_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

    A4.4/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct operation: comparing apps, fetching details, reviews, summaries, searching, listing categories, top apps, and private metrics. No overlap.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Nine tools cover the domain of Shopify app analytics and partner metrics comprehensively without unnecessary bloat or missing essentials.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      34
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      20
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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 npm
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live App Store rankings, charts, app details, reviews, and search across 55 countries, enabling AI assistants to query app store data.
      17 npm
      1
      MIT