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

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:

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

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