{"_id":"@codespar/mcp-shopify","_rev":"5-635ac36eadcac5cc0021502de7be59e9","name":"@codespar/mcp-shopify","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-shopify","version":"0.1.0","keywords":["mcp","shopify","ecommerce","orders","products","inventory","fulfillments","dtc","latam","brazil"],"license":"MIT","_id":"@codespar/mcp-shopify@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-shopify":"dist/index.js"},"dist":{"shasum":"d3eb239ff443b103ba36a00686d6806a8a28b51e","tarball":"https://registry.npmjs.org/@codespar/mcp-shopify/-/mcp-shopify-0.1.0.tgz","fileCount":6,"integrity":"sha512-FL9TmY2fVJ8N4+VK2xisYEKnxucfr3lLFspV/cOPeA6ROBEc9nijHlft2FBzqAcI1OO9pI0EsMHizwu9xC9Log==","signatures":[{"sig":"MEYCIQDQN1QyVRBKywXIDdwr9DaVFGL9D+CTLvY8utfEXe0B8AIhAI+/pICwnyqUQKTFLc6HCub7x7pM1cWGUih+Ca0jSaKz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44438},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b2ef93b78816f2643cd387941a09940b2d7619e9","mcpName":"io.github.codespar/mcp-shopify","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Shopify — global ecommerce platform Admin REST API (orders, products, customers, inventory, fulfillments, webhooks)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-shopify_0.1.0_1776996448097_0.5297947429738776","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-shopify","version":"0.2.0","keywords":["mcp","shopify","ecommerce","orders","products","inventory","fulfillments","dtc","latam","brazil"],"license":"MIT","_id":"@codespar/mcp-shopify@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-shopify":"dist/index.js"},"dist":{"shasum":"ba96f8f0e768ee5d098e7bf76a77c796bd490b98","tarball":"https://registry.npmjs.org/@codespar/mcp-shopify/-/mcp-shopify-0.2.0.tgz","fileCount":6,"integrity":"sha512-S9xIr2y0MQCQqJZA0sdbVrJZ2fJuVG+t7vVdLt+I1VwgYtN6P8dBFarEpd+Bfmbf5lIojZKucG6H4TEErWiYVQ==","signatures":[{"sig":"MEQCIClGn67mKECgyGqYAmYDcTE+64VRAZEaw/XTxkUILr7UAiBs88wrRbA4Jj8m5orsdQJP579xtzSrqSLPYLEhwohsIQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72741},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"22f6f8b78246bf63993b872baf8cea4da0d4414f","mcpName":"io.github.codespar/mcp-shopify","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Shopify — global ecommerce platform Admin REST API (orders, products, customers, inventory, fulfillments, webhooks)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-shopify_0.2.0_1777039655098_0.388813620655607","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-shopify","version":"0.2.1","keywords":["mcp","shopify","ecommerce","orders","products","inventory","fulfillments","dtc","latam","brazil"],"license":"MIT","_id":"@codespar/mcp-shopify@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-shopify":"dist/index.js"},"dist":{"shasum":"052ffb7c95a93c4807d02398e78510d49acc2949","tarball":"https://registry.npmjs.org/@codespar/mcp-shopify/-/mcp-shopify-0.2.1.tgz","fileCount":6,"integrity":"sha512-7yVeGxavYLkKbay7NvofBnYmEZXE0xTgxCzNrw+CSUp0It5XpjfeGRFpLHZjdsFP8JVJBnBPG1lwxvnIZ8bPrQ==","signatures":[{"sig":"MEUCIQDRwkRjy2cShHKBwgs+3XMMcrttlAtl3CVhs/4lOBsXAQIgFkck9Wkvk2cWHe5kEbBA2mM2RbLV8Y+jUWDx5sSRheM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74471},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-shopify","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Shopify — global ecommerce platform Admin REST API (orders, products, customers, inventory, fulfillments, webhooks)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-shopify_0.2.1_1777123054114_0.23876225173244014","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-shopify","version":"0.2.2","description":"MCP server for Shopify — global ecommerce platform Admin REST API (orders, products, customers, inventory, fulfillments, webhooks)","type":"module","main":"./dist/index.js","bin":{"mcp-shopify":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","shopify","ecommerce","orders","products","inventory","fulfillments","dtc","latam","brazil"],"mcpName":"io.github.codespar/mcp-shopify","_id":"@codespar/mcp-shopify@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-FOUY3aRgUmczocRfyFk8Rz2KNLHaxrocX1X6DirZloZ5vWknr7GU4SqY5rgD2DbjSm+L4T6hE3L4Q/9AWKFLsg==","shasum":"f070a02f71e30f44f4dfa3804e9be4e5e752f7f1","tarball":"https://registry.npmjs.org/@codespar/mcp-shopify/-/mcp-shopify-0.2.2.tgz","fileCount":6,"unpackedSize":75931,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGif8pGNjpf0blTxheoyuvpLs50X8QLv0OpniDK1AnvFAiEAzrZlQtk8NMeJ8ccDX4VzjoN9Lz7feCxz1R5zpSuzeCM="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-shopify_0.2.2_1782153586715_0.597133086146491"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T02:07:28.005Z","modified":"2026-06-22T18:39:47.016Z","0.1.0":"2026-04-24T02:07:28.213Z","0.2.0":"2026-04-24T14:07:35.250Z","0.2.1":"2026-04-25T13:17:34.250Z","0.2.2":"2026-06-22T18:39:46.858Z"},"license":"MIT","keywords":["mcp","shopify","ecommerce","orders","products","inventory","fulfillments","dtc","latam","brazil"],"description":"MCP server for Shopify — global ecommerce platform Admin REST API (orders, products, customers, inventory, fulfillments, webhooks)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-shopify\n\nMCP server for [Shopify](https://shopify.dev) — global ecommerce platform Admin REST API.\n\nShopify is the global DTC standard and dominant across LatAm for brands operating internationally (complementary to Nuvemshop/Tiendanube for regional-only merchants, also in this catalog). Agents building merchant tools — restocking, refund automation, marketing campaigns, fulfillment orchestration — integrate directly with the Admin API rather than through a reseller.\n\n## Tools (28)\n\n| Tool | Purpose |\n|---|---|\n| `list_orders` | List orders with optional filters. |\n| `get_order` | Get a single order by ID with full detail. |\n| `create_order` | Create a new order. |\n| `update_order` | Update an existing order (tags, note, email, shipping_address, metafields, etc). |\n| `cancel_order` | Cancel an order. |\n| `list_products` | List products with optional filters. |\n| `get_product` | Get a single product by ID including all variants and images. |\n| `create_product` | Create a new product with variants, options, and images. |\n| `update_product` | Update an existing product's fields, variants, or images. |\n| `list_customers` | List customers with optional query filter. |\n| `create_customer` | Create a new customer record. |\n| `adjust_inventory` | Adjust the available inventory for a specific inventory_item at a specific location by a delta (positive to... |\n| `create_fulfillment` | Create a fulfillment for an order (mark line items as shipped, attach tracking number and carrier). |\n| `update_fulfillment_tracking` | Update the tracking number, tracking company, or tracking URL on an existing fulfillment (post-ship trackin... |\n| `create_draft_order` | Create a draft order (invoice-style quote). |\n| `complete_draft_order` | Convert a draft order into a real order. |\n| `create_price_rule` | Create a price rule (the policy that governs discounts — percentage/fixed amount, prerequisites, entitlemen... |\n| `create_discount_code` | Create a discount code tied to an existing price rule (the customer-facing string like 'SUMMER20'). |\n| `create_smart_collection` | Create a smart collection — an automated collection populated by rules (e.g. |\n| `create_custom_collection` | Create a custom collection — a manually curated collection. |\n| `create_metafield` | Attach a metafield (custom typed field) to a resource (shop, product, variant, customer, order, collection,... |\n| `create_variant` | Add a new variant to an existing product (size/color/SKU permutation with its own price and inventory). |\n| `update_variant` | Update an existing product variant's price, SKU, barcode, options, weight, or inventory policy. |\n| `list_transactions` | List all payment transactions for an order (authorizations, captures, sales, refunds, voids) including gate... |\n| `list_abandoned_checkouts` | List abandoned checkouts (carts where the customer entered contact info but did not complete checkout). |\n| `list_locations` | List all fulfillment locations (physical stores, warehouses, 3PLs). |\n| `create_refund` | Refund one or more line items on an order. |\n| `register_webhook` | Register a webhook subscription for a Shopify event topic (orders/create, orders/paid, products/update, app... |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-shopify\n```\n\n## Environment\n\n```bash\nSHOPIFY_SHOP=\"acme\"               # subdomain (acme.myshopify.com)\nSHOPIFY_ACCESS_TOKEN=\"shpat_...\"  # Admin API access token (secret)\nSHOPIFY_API_VERSION=\"2024-01\"     # Optional. Defaults to 2024-01.\n```\n\n## Authentication\n\nPrivate/custom app access token sent as header on every request:\n\n```\nX-Shopify-Access-Token: <SHOPIFY_ACCESS_TOKEN>\n```\n\nCreate a custom app in Shopify admin → Settings → Apps and sales channels → Develop apps, grant the Admin API scopes you need (read/write orders, products, customers, inventory, fulfillments), and install to generate the token.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-shopify\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-shopify\n```\n\n## API surface\n\nUses the Shopify Admin REST API at `https://{shop}.myshopify.com/admin/api/{version}`. Default version is `2024-01` (stable). Override with `SHOPIFY_API_VERSION` when newer stable versions ship.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}