{"report":"{\"v\":1,\"package\":\"@shopify/dev-mcp\",\"version\":\"1.18.0\",\"ranAt\":\"2026-11-16T11:23:15.289Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-XvmIpe1TW3QHjV5gb+hbi9k8ucQuHd7uQhZ0F3T6Q72QG+fqFgpiaQ2N58TnHYNnuoxB0upTL6NsLYSliwQzvg==\",\"deps\":400,\"scripts\":[\"esbuild\",\"fsevents\",\"esbuild\"],\"bins\":[\"shopify-dev-mcp\"],\"license\":\"ISC\",\"bin\":\"shopify-dev-mcp\"},\"start\":{\"ok\":true,\"ms\":591,\"serverName\":\"shopify-dev-mcp\",\"serverVersion\":\"1.18.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"Shopify Dev MCP Server v1.18.0 running on stdio\\n\"},\"tools\":[{\"name\":\"feedback\",\"description\":\"Report an AI Toolkit capability scorecard grading how these Shopify tools performed this turn.\\n\\n⏱️ WHEN: Call EXACTLY ONCE, after ALL of the first turn's work is complete (every search, validation, and code generation attempt) and immediately before returning your final response to the user. Do NOT call it after individual searches, validations, or retries. Do NOT call it again on later turns.\\n\\nYou are grading the Shopify AI Toolkit (these tools and their docs), NOT your own performance. Do not guess: 'not_used' means the capability was not exercised this turn — it does not mean you are unsure.\\n\\n- docsContext: did toolkit docs (search_docs_chunks results, learn_shopify_api instructions) give enough context to work from? 'worked' = answered from them. 'partial' = needed supplementing from elsewhere. 'failed' = nothing usable, or wrong. 'not_used' = none consulted.\\n- schemaValidation: did validation tool verdicts match reality? 'worked' = passed code that worked, or caught a real error. 'partial' = caught something real but also flagged non-problems. 'failed' = passed broken code or rejected correct code. 'not_used' = no validator ran.\\n- apiVersion: 'worked' = right API version, no correction. 'partial' = corrected after a wrong choice. 'failed' = wrong version caused a problem. 'not_used' = nothing version-specific this turn.\\n- codegen: 'worked' = generated code compiled/ran/validated on the first serious attempt. 'partial' = got there after self-correction. 'failed' = didn't work by end of turn. 'not_used' = no code generated.\\n- overall: 'up' = the toolkit materially helped and nothing significant let you down. 'down' = a toolkit capability caused the turn to go badly. 'mixed' = otherwise.\\n- comment: up to 500 chars naming the capability that drove 'overall' and why. No code, no logs, no credentials, no user text beyond what's needed.\",\"params\":[\"conversationId\",\"overall\",\"docsContext\",\"schemaValidation\",\"apiVersion\",\"codegen\",\"comment\",\"sessionId\"]},{\"name\":\"learn_shopify_api\",\"description\":\"\\n    🚨 MANDATORY FIRST STEP: This tool MUST be called before any other Shopify tools.\\n\\n    ⚠️  ALL OTHER SHOPIFY TOOLS WILL FAIL without a conversationId from this tool.\\n    This tool generates a conversationId that is REQUIRED for all subsequent tool calls. After calling this tool, you MUST extract the conversationId from the response and pass it to every other Shopify tool call.\\n\\n    🔄 MULTIPLE API SUPPORT: You MUST call this tool multiple times in the same conversation when you need to learn about different Shopify APIs. THIS IS NOT OPTIONAL. Just pass the existing conversationId to maintain conversation continuity while loading the new API context.\\n\\n    For example, a user might ask a question about the Admin API, then switch to the Functions API, then ask a question about polaris UI components. In this case I would expect you to call learn_shopify_api three times with the following arguments:\\n\\n    - learn_shopify_api(api: \\\"admin\\\") -> conversationId: \\\"123\\\"\\n    - learn_shopify_api(api: \\\"functions\\\", conversationId: \\\"123\\\")\\n    - learn_shopify_api(api: \\\"polaris-admin-extensions\\\", conversationId: \\\"123\\\")\\n\\n    This is because the conversationId is used to maintain conversation continuity while loading the new API context.\\n\\n    🚨 Valid arguments for `api` are:\\n        - Flow workflows: Build and manage Shopify Flow workflows through the Admin GraphQL API: create, list, read, update, activate, deactivate, and delete workflows; parse .flow exports; and discover templates, tasks, and environment fields. Use `flow` first for workflow automation, including execution through Shopify CLI. For building an app's Flow trigger or action extension, use `admin` and the extension docs.\\n    - Use Shopify CLI: Choose when the user needs **Shopify CLI** to run or fix something now: validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`, `shopify.extension.toml`); review or audit an app's code for security vulnerabilities; run or troubleshoot store workflows (`shopify store auth`, `shopify store execute`); or perform explicit store-scoped reads/writes on a named store domain (for example, show/list/find the first 10 products on my store at `foo.myshopify.com`, or inventory and product changes by handle, SKU, or location name). Emphasize **commands and operational steps**, not only authoring GraphQL. Skip for API-only understanding or codegen with no CLI execution, and skip for brand-new merchant asks to start a Shopify store or try Shopify before they have an account. Examples: validate configuration before deploy; run an existing query via CLI; show the first 10 products on `foo.myshopify.com`; missing `shopify store execute`.\\n    - UCP CLI: Use when the user wants to use the UCP CLI to find, compare, buy, or track products from online merchants, or to set up and troubleshoot the local UCP profile required for merchant-scoped operations. Covers global catalog search (\\\"find me X under $Y\\\"), named-merchant transactions (\\\"buy this fro\",\"params\":[\"api\",\"version\",\"conversationId\",\"model\",\"user_prompt\"]},{\"name\":\"search_docs_chunks\",\"description\":\"This tool will take in the user prompt, search shopify.dev, and return relevant documentation and code examples that will help answer the user's question.\",\"params\":[\"conversationId\",\"prompt\",\"max_num_results\",\"api_name\",\"version\"]},{\"name\":\"validate\",\"description\":\"🚨 MANDATORY after generating or editing Shopify code: GraphQL operations, UI components (JSX/TSX or web components). Do not ask the user to run it, do not skip it for short snippets, do not context-switch.\\n\\nCatches hallucinated types, fields, components, props and prop values against the bundled references. One call validates one `api`, so batch the blocks that share one and make a second call for a different one — a turn with a GraphQL operation and a Polaris component needs two. Generate → validate → fix → re-validate until clean.\\n\\n\\n    It returns a comprehensive validation result with details for each code block explaining why it was valid or invalid.\\n    This detail is provided so LLMs know how to modify code snippets to remove errors.\\n    It also returns an artifact ID and revision number for each code block. This is used to track the code block and its validation results. When validating an iteration of the same code block, use the same artifact ID and increment the revision number. Do not pass your own artifact ID to this tool, the tool will generate one for you.\",\"params\":[\"conversationId\",\"api\",\"code\",\"version\",\"extensionTarget\"]},{\"name\":\"validate_theme\",\"description\":\"This tool validates Liquid codeblocks, Liquid files, and supporting Theme files (e.g. JSON locale files, JSON config files, JSON template files, JavaScript files, CSS files, and SVG files) generated or updated by LLMs to ensure they don't have hallucinated Liquid content, invalid syntax, or incorrect references\\n\\n    It returns a comprehensive validation result with details for each code block explaining why it was valid or invalid.\\n    This detail is provided so LLMs know how to modify code snippets to remove errors.\\n    It also returns an artifact ID and revision number for each code block. This is used to track the code block and its validation results. When validating an iteration of the same code block, use the same artifact ID and increment the revision number. Do not pass your own artifact ID to this tool, the tool will generate one for you.. Run this tool if the user is creating, updating, or deleting files inside of a Shopify Theme directory.\",\"params\":[\"conversationId\",\"absoluteThemePath\",\"filesCreatedOrUpdated\"]}],\"toolsHash\":\"0075057f45c0187ecc3c3c2a9523f3bd5a3691e15dc1d8054dc2ba939476c6fd\",\"wrote\":[],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjZiOGYyOThmODM2ZGVlOTdiZDg2OWI3MGEwZDQ3MTA5NDNmOTYxMTc0YmEyNjA0ZGQ5OGY3MWRjOGY0NmI1ZWMiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTQyOCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyODUyNiwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MjgyMjYsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiODUzYWYyMDEtYjhhYi00NTNlLWFiMzItNGZlODU5OTMxNTkwIiwibmJmIjoxNzk0ODI3OTI2LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.BDYPK8TAwHahdd7bxz6BixYgoUKLAVCnnkd9Z_Fi6eD_XuruO4MbQJcOdyg6QC4yqwXwAvS7yWMFwf6_SdXEUub53eyjsBH1UrHhhipEsY6SKcSYqm21BAgVAFLOt89GSOT9iL5HyMkoUZ1L4viQ944MOR8PT_J-DIABV9NdX2brnbQ7A0kg5R_EFJDO_44ODnHhaQQ_MRPo8JkBKAJrk5pgtReKHmRlT2ZAsOqbRitRBCmI7m6L5frfPB5PZGl3i-TyQL-5v2RApAL-TwLMRKdDMTRFQRQKC_AACoBi08s9GtTvq1jMK7ZH6c7ctawZ0TvKVjiK1g1tqfoNas3Czw"}