{"_id":"shopify-store-mcp","_rev":"4-03c3c9f05057c76f126a69694f39f5ef","name":"shopify-store-mcp","dist-tags":{"latest":"1.0.10"},"versions":{"1.0.0":{"name":"shopify-store-mcp","version":"1.0.0","keywords":["mcp","modelcontextprotocol","shopify","admin-api","graphql","ai","claude","cursor"],"author":{"name":"Brahim Benzarti"},"license":"ISC","_id":"shopify-store-mcp@1.0.0","maintainers":[{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"}],"homepage":"https://github.com/ibrahimbenzarti/shopify-store-mcp#readme","bugs":{"url":"https://github.com/ibrahimbenzarti/shopify-store-mcp/issues"},"bin":{"shopify-store-mcp":"dist/index.js"},"dist":{"shasum":"09f7884fb972592697f6becbda87724dcb401442","tarball":"https://registry.npmjs.org/shopify-store-mcp/-/shopify-store-mcp-1.0.0.tgz","fileCount":88,"integrity":"sha512-h3WM2kHTtq9Snx5D230zbXuG3KqHZfGyKg2BFt/kcCREtvglEZlDZovQqVnYnoFLHjESRJbITjEaPXUBOq2B/Q==","signatures":[{"sig":"MEUCIQDSwx1ZJq7teIG9e/9MecdlJyetp3bAI38WrGW1AGi75wIgOBjK+dLEfhmrMkoWrIIL2b8mVQ4Rc0YQ+VCKti2PC88=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":203977},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"524eec94137b4e9d9b7832fa3891b1d29320e386","scripts":{"dev":"tsc --watch","build":"prisma generate && tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js","db:push":"prisma db push","inspect":"npm run build && npx @modelcontextprotocol/inspector dist/index.js","db:studio":"prisma studio","typecheck":"tsc --noEmit","db:generate":"prisma generate","prepublishOnly":"npm run build","graphql-codegen":"graphql-codegen -p=adminApi && graphql-codegen -p=storefrontApi","graphql-codegen:admin":"graphql-codegen -p=adminApi","graphql-codegen:watch":"graphql-codegen --watch","graphql-codegen:storefront":"graphql-codegen -p=storefrontApi"},"_npmUser":{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"},"overrides":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"repository":{"url":"git+https://github.com/ibrahimbenzarti/shopify-store-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for Shopify store operations via Admin and Storefront APIs","directories":{},"resolutions":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","dotenv":"^16.4.5","p-queue":"^8.0.1","@prisma/client":"^6.3.0","@modelcontextprotocol/sdk":"^1.11.0","@shopify/admin-api-client":"^1.1.0","@shopify/storefront-api-client":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"prisma":"^6.3.0","graphql":"^16.9.0","typescript":"^5.6.0","@types/node":"^22.0.0","graphql-config":"^5.1.0","@graphql-codegen/cli":"^5.0.0","@shopify/api-codegen-preset":"^1.1.1"},"_npmOperationalInternal":{"tmp":"tmp/shopify-store-mcp_1.0.0_1770917932953_0.7412159714864743","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"shopify-store-mcp","version":"1.0.1","keywords":["mcp","modelcontextprotocol","shopify","admin-api","graphql","ai","claude","cursor"],"author":{"name":"Brahim Benzarti"},"license":"ISC","_id":"shopify-store-mcp@1.0.1","maintainers":[{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"}],"homepage":"https://github.com/Brahim-Benzarti/Shopify_store-MCP#readme","bugs":{"url":"https://github.com/Brahim-Benzarti/Shopify_store-MCP/issues"},"bin":{"shopify-store-mcp":"dist/index.js"},"dist":{"shasum":"c145af3d1eec769c86595e19f4605099ead25d29","tarball":"https://registry.npmjs.org/shopify-store-mcp/-/shopify-store-mcp-1.0.1.tgz","fileCount":88,"integrity":"sha512-armz1gwYV8N/2YSnTk7pzX2UAqr800UGh8SNl2DuU8o8MLgP+zOdA6H3YM/wr+IgT5sKfxFzXxGr2/dmL678ag==","signatures":[{"sig":"MEUCIGcyFU74fR+N9OiytB+PUtHzEEiIQECgdzmH1doWLkeDAiEA01vnyDz3Z2kw72CuyKWjS5Lz3w/HCNuamsmLrzktQw0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":204524},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"225a3af0d6430862219c99f68b9f5a63b44ef6ff","scripts":{"dev":"tsc --watch","build":"prisma generate && tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js","db:push":"prisma db push","inspect":"npm run build && npx @modelcontextprotocol/inspector dist/index.js","db:studio":"prisma studio","typecheck":"tsc --noEmit","db:generate":"prisma generate","prepublishOnly":"npm run build","graphql-codegen":"graphql-codegen -p=adminApi && graphql-codegen -p=storefrontApi","graphql-codegen:admin":"graphql-codegen -p=adminApi","graphql-codegen:watch":"graphql-codegen --watch","graphql-codegen:storefront":"graphql-codegen -p=storefrontApi"},"_npmUser":{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"},"overrides":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"repository":{"url":"git+https://github.com/Brahim-Benzarti/Shopify_store-MCP.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for Shopify store operations via Admin and Storefront APIs","directories":{},"resolutions":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","dotenv":"^16.4.5","p-queue":"^8.0.1","@prisma/client":"^6.3.0","@modelcontextprotocol/sdk":"^1.11.0","@shopify/admin-api-client":"^1.1.0","@shopify/storefront-api-client":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"prisma":"^6.3.0","graphql":"^16.9.0","typescript":"^5.6.0","@types/node":"^22.0.0","graphql-config":"^5.1.0","@graphql-codegen/cli":"^5.0.0","@shopify/api-codegen-preset":"^1.1.1"},"_npmOperationalInternal":{"tmp":"tmp/shopify-store-mcp_1.0.1_1770972192386_0.7827115760983177","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"shopify-store-mcp","version":"1.0.2","keywords":["mcp","modelcontextprotocol","shopify","admin-api","graphql","ai","claude","cursor"],"author":{"name":"Brahim Benzarti"},"license":"ISC","_id":"shopify-store-mcp@1.0.2","maintainers":[{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"}],"homepage":"https://github.com/Brahim-Benzarti/Shopify_store-MCP#readme","bugs":{"url":"https://github.com/Brahim-Benzarti/Shopify_store-MCP/issues"},"bin":{"shopify-store-mcp":"dist/index.js"},"dist":{"shasum":"f6705feb770d0968a3219dd18cd03a5481a7f76a","tarball":"https://registry.npmjs.org/shopify-store-mcp/-/shopify-store-mcp-1.0.2.tgz","fileCount":88,"integrity":"sha512-0ItGs5GTjnKcJZQ9h9HZgo1a9ymbwzhmiBdiazFMH/ibDco6u7zX3W8gdcT/mhGx3nYkiod7rYahEtsoT/2MCA==","signatures":[{"sig":"MEQCIG7atr5mLNxaKPPBzCEmfwMaan7Kl3HawsWbffmt2vYoAiAuEcPXJ68VjanPD6r3Vhj1Lb0bDOckM0uI/npq+mXW0w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":204562},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9e72674a6e94e87775bdf73ce2750e2cae35b8d5","scripts":{"dev":"tsc --watch","build":"prisma generate && tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js","db:push":"prisma db push","inspect":"npm run build && npx @modelcontextprotocol/inspector dist/index.js","db:studio":"prisma studio","typecheck":"tsc --noEmit","db:generate":"prisma generate","postinstall":"prisma generate","prepublishOnly":"npm run build","graphql-codegen":"graphql-codegen -p=adminApi && graphql-codegen -p=storefrontApi","graphql-codegen:admin":"graphql-codegen -p=adminApi","graphql-codegen:watch":"graphql-codegen --watch","graphql-codegen:storefront":"graphql-codegen -p=storefrontApi"},"_npmUser":{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"},"overrides":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"repository":{"url":"git+https://github.com/Brahim-Benzarti/Shopify_store-MCP.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for Shopify store operations via Admin and Storefront APIs","directories":{},"resolutions":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","dotenv":"^16.4.5","prisma":"^6.3.0","p-queue":"^8.0.1","@prisma/client":"^6.3.0","@modelcontextprotocol/sdk":"^1.11.0","@shopify/admin-api-client":"^1.1.0","@shopify/storefront-api-client":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"graphql":"^16.9.0","typescript":"^5.6.0","@types/node":"^22.0.0","graphql-config":"^5.1.0","@graphql-codegen/cli":"^5.0.0","@shopify/api-codegen-preset":"^1.1.1"},"_npmOperationalInternal":{"tmp":"tmp/shopify-store-mcp_1.0.2_1770973139911_0.32790119071361756","host":"s3://npm-registry-packages-npm-production"}},"1.0.10":{"name":"shopify-store-mcp","version":"1.0.10","description":"MCP server for Shopify store operations via Admin and Storefront APIs","author":{"name":"Brahim Benzarti"},"license":"ISC","type":"module","main":"dist/index.js","bin":{"shopify-store-mcp":"dist/index.js"},"keywords":["mcp","modelcontextprotocol","shopify","admin-api","graphql","ai","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/Brahim-Benzarti/Shopify_store-MCP.git"},"bugs":{"url":"https://github.com/Brahim-Benzarti/Shopify_store-MCP/issues"},"homepage":"https://github.com/Brahim-Benzarti/Shopify_store-MCP#readme","engines":{"node":">=18.0.0"},"scripts":{"postinstall":"prisma generate","build":"prisma generate && tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","dev":"tsc --watch","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector dist/index.js","typecheck":"tsc --noEmit","graphql-codegen":"graphql-codegen -p=adminApi && graphql-codegen -p=storefrontApi","graphql-codegen:admin":"graphql-codegen -p=adminApi","graphql-codegen:storefront":"graphql-codegen -p=storefrontApi","graphql-codegen:watch":"graphql-codegen --watch","db:generate":"prisma generate","db:push":"prisma db push","db:studio":"prisma studio","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","@prisma/client":"^6.3.0","@shopify/admin-api-client":"^1.1.0","@shopify/storefront-api-client":"^1.0.0","dotenv":"^16.4.5","p-queue":"^8.0.1","prisma":"^6.3.0","zod":"^3.23.0"},"devDependencies":{"@graphql-codegen/cli":"^5.0.0","@shopify/api-codegen-preset":"^1.1.1","@types/mime-types":"^3.0.1","@types/node":"^22.0.0","graphql":"^16.9.0","graphql-config":"^5.1.0","typescript":"^5.6.0"},"resolutions":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"overrides":{"@graphql-tools/url-loader":"8.0.16","@graphql-codegen/client-preset":"4.7.0","@graphql-codegen/typescript-operations":"4.5.0"},"gitHead":"a13f219ab8a9aad213cc5f1fab09f8093696ffad","types":"./dist/index.d.ts","_id":"shopify-store-mcp@1.0.10","_nodeVersion":"25.5.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-Dn3zuKZuPWgM1Xt9fv55UGpvW68APlu8XYhcEJ8CRjao0a+EouitAmRdORfVCzgcluGbLzxgfKEq3PpoLKf7jA==","shasum":"399177feeda69226595280ca1e855ee3eeca4f72","tarball":"https://registry.npmjs.org/shopify-store-mcp/-/shopify-store-mcp-1.0.10.tgz","fileCount":88,"unpackedSize":230286,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC311FkzB49LAH3ZRmoTHUQRVfRFFu5PVEpMvMExp8LfAiBSnTstzJfa9y8eUUIwvzhwnltgeeI/hsJCgPDso5YZpQ=="}]},"_npmUser":{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"},"directories":{},"maintainers":[{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/shopify-store-mcp_1.0.10_1770989522723_0.7238469979042981"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-12T17:38:52.952Z","modified":"2026-02-13T13:32:03.033Z","1.0.0":"2026-02-12T17:38:53.102Z","1.0.1":"2026-02-13T08:43:12.521Z","1.0.2":"2026-02-13T08:59:00.055Z","1.0.10":"2026-02-13T13:32:02.915Z"},"bugs":{"url":"https://github.com/Brahim-Benzarti/Shopify_store-MCP/issues"},"author":{"name":"Brahim Benzarti"},"license":"ISC","homepage":"https://github.com/Brahim-Benzarti/Shopify_store-MCP#readme","keywords":["mcp","modelcontextprotocol","shopify","admin-api","graphql","ai","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/Brahim-Benzarti/Shopify_store-MCP.git"},"description":"MCP server for Shopify store operations via Admin and Storefront APIs","maintainers":[{"name":"brahim-benzarti","email":"brahim.al.benzarti@gmail.com"}],"readme":"# Shopify Store MCP Server\n\n[![npm version](https://img.shields.io/npm/v/shopify-store-mcp.svg)](https://www.npmjs.com/package/shopify-store-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/shopify-store-mcp.svg)](https://www.npmjs.com/package/shopify-store-mcp)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue.svg)](https://www.typescriptlang.org/)\n\nA Model Context Protocol (MCP) server that connects to **live Shopify stores** via the Admin and Storefront APIs. Unlike documentation-only MCPs, this server enables AI agents to perform **real operations** on your store.\n\n## Why This MCP?\n\n| Feature | Shopify Store MCP | [Shopify Dev MCP](https://shopify.dev/docs/apps/build/devmcp) |\n|---------|-------------------|---------------------------------------------------------------|\n| Execute GraphQL queries | ✅ Real API calls | ❌ Documentation only |\n| Modify store data | ✅ Full CRUD | ❌ No |\n| Upload files | ✅ Yes | ❌ No |\n| Bulk operations | ✅ Yes | ❌ No |\n| API documentation | ❌ No | ✅ Yes |\n| Schema introspection | ❌ No | ✅ Yes |\n\n> **Important:** For the best experience, use **both** this MCP and the official [Shopify Dev MCP](https://shopify.dev/docs/apps/build/devmcp) together. The Dev MCP helps your AI agent understand Shopify's API schemas and documentation, while this MCP executes the actual operations on your store.\n\n## Features\n\n- **Universal GraphQL Access** — Execute any Admin API query or mutation via `run_graphql_query`\n- **Smart Multi-Step Tools** — File uploads, bulk operations, metaobject upserts with automatic polling\n- **Rate Limiting** — Respects Shopify's plan-based rate limits (Standard/Advanced/Plus/Enterprise)\n- **Operation Logging** — SQLite database tracks all operations for debugging and history\n- **Schema Discovery** — Explore your store's metafield definitions and metaobject types\n\n## Prerequisites\n\n1. **Node.js 18+**\n2. **Shopify store** with a [custom app](https://help.shopify.com/en/manual/apps/app-types/custom-apps)\n3. **Admin API access token** — Create a custom app in Shopify Admin → Settings → Apps and development channels → Develop apps\n\n## Installation\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\n### Quick Install\n\n[![Install in Cursor](https://img.shields.io/badge/Install%20in-Cursor-blue?style=for-the-badge&logo=cursor)](https://cursor.com/install-mcp?name=shopify-store-mcp&config=eyJtY3BTZXJ2ZXJzIjp7InNob3BpZnktc3RvcmUtbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15Iiwic2hvcGlmeS1zdG9yZS1tY3AiXSwiZW52Ijp7IlNIT1BJRllfU1RPUkVfVVJMIjoieW91ci1zdG9yZS5teXNob3BpZnkuY29tIiwiU0hPUElGWV9BQ0NFU1NfVE9LRU4iOiJzaHBhdF94eHh4eHh4eHh4eHh4eHh4eHh4eHgifX19fQ==)\n\nAfter installing, edit the configuration to add your actual store credentials.\n\n### Manual Configuration\n\nAdd to your Cursor MCP settings (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Windows Configuration</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/k\", \"npx\", \"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n</details>\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to your Claude Desktop config:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Windows Configuration</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/k\", \"npx\", \"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n</details>\n\n<details>\n<summary><strong>Claude Code (CLI)</strong></summary>\n\nAdd to your Claude Code settings (`~/.claude/settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>VS Code (Copilot)</strong></summary>\n\nAdd to your VS Code settings (`settings.json`):\n\n```json\n{\n  \"mcp.servers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Windsurf</strong></summary>\n\nAdd to your Windsurf MCP config (`~/.windsurf/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Other MCP Clients</strong></summary>\n\nFor any MCP-compatible client, use:\n\n```bash\nnpx -y shopify-store-mcp\n```\n\nWith environment variables:\n- `SHOPIFY_STORE_URL` — Your store's myshopify.com domain\n- `SHOPIFY_ACCESS_TOKEN` — Admin API access token\n\n</details>\n\n## Recommended: Add Shopify Dev MCP\n\nFor the best AI agent experience, also add the official **[Shopify Dev MCP](https://shopify.dev/docs/apps/build/devmcp)**. It provides:\n\n- API documentation search\n- GraphQL schema introspection\n- Query validation\n- Up-to-date Shopify API knowledge\n\nThis helps your AI agent know **what queries to write** before executing them with this MCP.\n\n```json\n{\n  \"mcpServers\": {\n    \"shopify-store-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shopify-store-mcp\"],\n      \"env\": {\n        \"SHOPIFY_STORE_URL\": \"your-store.myshopify.com\",\n        \"SHOPIFY_ACCESS_TOKEN\": \"shpat_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    },\n    \"shopify-dev-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@shopify/dev-mcp@latest\"]\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `SHOPIFY_STORE_URL` | Yes | — | Store's myshopify.com domain |\n| `SHOPIFY_ACCESS_TOKEN` | Yes | — | Admin API access token |\n| `SHOPIFY_STOREFRONT_ACCESS_TOKEN` | No | — | Storefront API token |\n| `SHOPIFY_API_VERSION` | No | `2026-01` | API version (or `unstable` for bleeding edge) |\n| `SHOPIFY_TIER` | No | `STANDARD` | Rate limit tier |\n| `MCP_LOG_OPERATIONS` | No | `true` | Enable operation logging |\n\n## Available Tools\n\n### Core Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_shop_info` | Retrieve store configuration, plan info, and settings |\n| `run_graphql_query` | **Universal tool** — Execute any GraphQL query or mutation |\n\n### Smart Tools\n\nMulti-step workflows that handle complexity automatically:\n\n| Tool | Description |\n|------|-------------|\n| `upload_file` | Upload file (URL, local path, or base64) → poll until ready → return CDN URL |\n| `bulk_export` | Start bulk query → poll completion → return JSONL download URL |\n| `bulk_import` | Staged upload → bulk mutation → poll completion |\n| `upsert_metaobject` | Create or update metaobject by handle (idempotent) |\n| `delete_metaobject` | Delete metaobject by ID or type+handle |\n| `schema_discover` | Discover metafield definitions and metaobject types |\n\n### Infrastructure Tools\n\n| Tool | Description |\n|------|-------------|\n| `configure` | Set rate limit tier (manual or auto-detect from shop plan) |\n| `get_history` | Query past operations for debugging |\n| `get_stats` | Aggregated usage statistics (calls, errors, response times) |\n\n## Rate Limiting\n\nThe server automatically respects Shopify's rate limits based on your shop plan:\n\n| Tier | Requests/sec | Plans |\n|------|--------------|-------|\n| `STANDARD` | 1 | Basic, Development, Lite |\n| `ADVANCED` | 2 | Advanced |\n| `PLUS` | 5 | Shopify Plus |\n| `ENTERPRISE` | 10 | Commerce Components |\n\nUse the `configure` tool to set your tier or auto-detect from your shop plan.\n\n## Available Prompts\n\n| Prompt | Description |\n|--------|-------------|\n| `analyze-product` | Product analysis template |\n| `summarize-orders` | Order summary by timeframe |\n| `inventory-health` | Inventory health check |\n| `customer-insights` | Customer segment analysis |\n| `custom-query` | Help building custom GraphQL queries |\n\n## Available Resources\n\n| Resource | Description |\n|----------|-------------|\n| `shopify://config` | Current store connection info |\n| `shopify://docs/query-syntax` | Query syntax reference |\n| `shopify://docs/gid-format` | GID format reference |\n| `shopify://docs/scopes` | API scopes reference |\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/Brahim-Benzarti/Shopify_store-MCP.git\ncd Shopify_store-MCP\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run with MCP Inspector\nnpm run inspect\n\n# Watch mode\nnpm run dev\n\n# View database\nnpm run db:studio\n```\n\n### Database\n\nThe server uses SQLite for operation logging and configuration. Database is automatically created at `~/.shopify-mcp/mcp.db`.\n\n## Security\n\n- **Never commit** your `.env` file or access tokens\n- Use **environment variables** or MCP config for credentials\n- Access tokens should have **minimal required scopes**\n- Operations are logged locally for debugging (disable with `MCP_LOG_OPERATIONS=false`)\n\n## License\n\n[ISC](LICENSE)\n\n## Related\n\n- [Shopify Dev MCP](https://shopify.dev/docs/apps/build/devmcp) — Official Shopify MCP for API documentation\n- [Shopify Admin API](https://shopify.dev/docs/api/admin-graphql) — GraphQL API reference\n- [Model Context Protocol](https://modelcontextprotocol.io/) — MCP specification\n","readmeFilename":"README.md"}