MCP.Market

Shopify Theme Inspector MCP server

by dragnoir·io.github.dragnoir/shopify-theme-inspector·v0.5.1
No reviews yet

Profile Shopify Liquid performance, find slow theme code, and explain fixes in plain language.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

0 stars40 downloads/wk

Reviews

Write one

Nobody has reviewed Shopify Theme Inspector yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Shopify Theme Inspector tools (16, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • analyze_liquid_file

    Statically analyze a specific Liquid file for performance anti-patterns. Requires legacy cookie authentication (use 'login_legacy' tool).

  • batch_profile

    Profile multiple pages on the same store in a single call. Returns a summary comparison of all pages sorted by render time. Useful for finding the slowest pages on a site. Maximum 10 pages per call.

  • compare_pages

    Profile two pages on the same store and compare their performance side-by-side. Shows differences in render time, template breakdown, and recommendations. Great for A/B testing template changes or comparing product vs collection page performance.

  • complete_login_in_chrome

    Complete a login_in_chrome flow using the full final chromiumapp.org callback URL copied from Chrome's address bar.

  • export_profile

    Profile a page and export the results in a specified format. Supported formats: 'speedscope' (JSON for speedscope.app visualization), 'csv' (spreadsheet-friendly), 'markdown' (shareable report with tables, recommendations, and severity badges). Can save to a file or return inline.

  • find_slow_templates

    Identify Liquid templates and sections that are taking longer than a specified threshold to render. Requires OAuth2 authentication.

  • get_auth_status

    Check authentication status. Shows both OAuth2 (for profiling) and legacy (for Admin API) authentication.

  • get_bottlenecks

    Profile a page and automatically detect performance anti-patterns. Returns prioritized recommendations with severity ratings (critical/warning/info), specific file/line locations, measured impact, and concrete fix suggestions. This is the BEST tool for identifying what to optimize.

  • get_profile_history

    View profiling history and performance trends for a store. Shows how render times have changed over time. Every profiling call is automatically saved to history. Use this to track the impact of optimizations.

  • get_profile_summary

    Profile a Shopify store page and return a structured performance summary with top slow nodes and template breakdown. More readable than raw profile_page data. Requires OAuth2 authentication first.

  • health_check

    Check if the Shopify Theme Inspector MCP server is running correctly

  • login

    Authenticate with Shopify via OAuth2 (same method as the Chrome Theme Inspector extension). Opens a browser for you to log in. This provides full flame graph profiling data.

  • login_in_chrome

    Start Shopify OAuth in the user's existing Chrome profile without closing Chrome. After authorization, copy the full final callback URL and pass it to complete_login_in_chrome.

  • login_legacy

    Legacy cookie-based Shopify login. Opens browser for manual login. Required for 'analyze_liquid_file' tool which needs Admin API access. Use 'login' (OAuth2) for profiling tools.

  • logoutwrite action

    Remove saved authentication (both OAuth2 and legacy sessions) for a Shopify store

  • profile_page

    Profile a Shopify store page to analyze Liquid template rendering performance. Returns FULL flame graph profiling data (same as Chrome extension). Requires OAuth2 authentication first (use the 'login' tool).

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan33 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 12 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Shopify Theme Inspector compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 93% of 2,174 E-commerce servers
Tools
16
the typical E-commerce server has 6
Tools that change things
6%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
40
more than 38% of 411 E-commerce servers with a package

What its tools let an agent do: 15 read · 1 change

Install Shopify Theme Inspector in Claude Code, Cursor or VS Code

Runs npx -y shopify-theme-inspector-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add shopify-theme-inspector -- npx -y shopify-theme-inspector-mcp
Add to Cursor

What the publisher says

From the Shopify Theme Inspector repository's README, as published. We do not edit it. Read it on GitHub

Shopify Theme Inspector MCP

Ask your AI assistant why a Shopify theme is slow—and get a report that points to the Liquid files and lines worth fixing.

Shopify Theme Inspector MCP connects Shopify's server-side Liquid profiler to AI tools such as Codex, Claude Desktop, Cursor, Windsurf, and VS Code. It measures a live storefront, finds expensive templates and repeated work, compares pages, and turns flame-graph data into readable recommendations.

You do not need to be a programmer to run a report. If your AI app supports MCP, the setup is mostly copy, paste, sign in, and ask a question.

[!NOTE]

This is an unofficial community project. It is not affiliated with or supported by Shopify.

Shopify store owner? Start here

This tool helps answer a practical question:

Which parts of my Shopify theme are making Shopify work harder before it can send the page to a customer?

You can ask that question in normal language. Your AI assistant runs the technical checks, reads Shopify's profiling data, and explains the findings without expecting you to understand a flame graph.

For example, a report can tell you that:

  • A homepage section is doing a large amount of server-side work.
  • The same product, menu, price, or image code is being rendered many times.
  • A third-party app block appears frequently in the slowest part of the profile.
  • A collection or product template deserves attention before less important code.
  • A recent theme change improved, worsened, or did not meaningfully change Liquid render time.

The result is a prioritized investigation plan that you can understand yourself or give to a Shopify developer. It helps replace “the store feels slow” with evidence about which Liquid files, sections, snippets, and operations deserve attention.

[!IMPORTANT]

The MCP diagnoses and explains potential theme bottlenecks. It does not automatically edit or publish your live theme. A theme developer should review, test, and deploy code changes safely—ideally on a duplicate theme first.

What does “MCP” mean?

MCP stands for Model Context Protocol. In simple terms, it is a way to give an AI assistant access to a specialized set of tools.

Without this MCP, an AI assistant cannot normally request your store's Shopify Liquid performance profile directly. With it, the assistant can run authorized, read-only profiling checks and discuss the results with you.

Think of it as a local bridge:

You ask a question
        ↓
Your AI assistant chooses the right inspection tool
        ↓
Shopify returns Liquid profiling data for the requested page
        ↓
The AI explains the evidence and suggests what to investigate

How it can help your Shopify business

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Shopify Theme Inspector: common questions

Is Shopify Theme Inspector MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Shopify Theme Inspector safety report
How do I install Shopify Theme Inspector?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Shopify Theme Inspector need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Shopify Theme Inspector maintained?
The last commit was 52 days ago (2026-09-13). The latest release is v0.5.1.
What can I use instead of Shopify Theme Inspector?
Servers from other publishers that do the same job: Heimdall MCP server, Polymarket Toolkit MCP server and HasData Amazon MCP server.
How does Shopify Theme Inspector compare with other E-commerce MCP servers?
safety score 92/100 (higher than 93% of 2,174 E-commerce servers); tools 16 (the typical E-commerce server has 6); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Shopify Theme Inspector

Same job from other publishers: the closest match first, then the best rated.

  • Heimdall
    Every App Store Connect + StoreKit 2 endpoint. 929 tools in 13 profiles, narrow to 27.
    B
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • HasData Amazon
    Amazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.
    More from hasdata.com →
    A
  • Markifact - Ads & Analytics
    AI marketing agent for Google Ads, Meta, GA4, TikTok, LinkedIn, Shopify, HubSpot and more.
    A
  • Shopify
    MCP server for Shopify — Admin REST API (orders, products, customers, inventory, fulfillments)
    B