@anton.andrusenko/shopify-mcp-admin 0.3.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -6
- package/dist/index.js +1250 -649
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @anton.andrusenko/shopify-mcp-admin
|
|
2
2
|
|
|
3
|
-
> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with
|
|
3
|
+
> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 45 powerful tools
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@anton.andrusenko/shopify-mcp-admin)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
|
|
12
12
|
## ✨ Features
|
|
13
13
|
|
|
14
|
-
- 🛠️ **
|
|
14
|
+
- 🛠️ **45 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, markets
|
|
15
15
|
- 🤖 **AI-Optimized** — Tool descriptions and error messages designed for LLM comprehension
|
|
16
16
|
- 🔌 **Dual Transport** — STDIO for Claude Desktop, HTTP for ChatGPT/OpenAI
|
|
17
17
|
- ⚡ **Rate Limiting** — Automatic retry with exponential backoff for Shopify API limits
|
|
@@ -120,6 +120,7 @@ Configure these scopes when creating your Custom App:
|
|
|
120
120
|
| `read_inventory`, `write_inventory` | Inventory management |
|
|
121
121
|
| `read_content`, `write_content` | Pages, blogs, articles |
|
|
122
122
|
| `read_online_store_navigation`, `write_online_store_navigation` | URL redirects |
|
|
123
|
+
| `read_markets`, `write_markets` | Markets (international selling) |
|
|
123
124
|
|
|
124
125
|
📖 **Setup Guide:** [Shopify Custom App Documentation](https://shopify.dev/docs/apps/tools/development-stores)
|
|
125
126
|
|
|
@@ -143,7 +144,7 @@ Edit your Claude Desktop configuration file:
|
|
|
143
144
|
"mcpServers": {
|
|
144
145
|
"shopify": {
|
|
145
146
|
"command": "npx",
|
|
146
|
-
"args": ["@anton.andrusenko/shopify-mcp-admin"],
|
|
147
|
+
"args": ["-y", "@anton.andrusenko/shopify-mcp-admin"],
|
|
147
148
|
"env": {
|
|
148
149
|
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
|
|
149
150
|
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
|
|
@@ -160,7 +161,7 @@ Edit your Claude Desktop configuration file:
|
|
|
160
161
|
"mcpServers": {
|
|
161
162
|
"shopify": {
|
|
162
163
|
"command": "npx",
|
|
163
|
-
"args": ["@anton.andrusenko/shopify-mcp-admin"],
|
|
164
|
+
"args": ["-y", "@anton.andrusenko/shopify-mcp-admin"],
|
|
164
165
|
"env": {
|
|
165
166
|
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
|
|
166
167
|
"SHOPIFY_CLIENT_ID": "xxxxx",
|
|
@@ -247,7 +248,7 @@ Each tool can be converted to OpenAI function format:
|
|
|
247
248
|
|
|
248
249
|
## 🛠️ Available Tools
|
|
249
250
|
|
|
250
|
-
@anton.andrusenko/shopify-mcp-admin provides **
|
|
251
|
+
@anton.andrusenko/shopify-mcp-admin provides **45 tools** organized into 8 categories:
|
|
251
252
|
|
|
252
253
|
<details>
|
|
253
254
|
<summary><strong>📦 Product Management (7 tools)</strong></summary>
|
|
@@ -353,6 +354,19 @@ Each tool can be converted to OpenAI function format:
|
|
|
353
354
|
|
|
354
355
|
</details>
|
|
355
356
|
|
|
357
|
+
<details>
|
|
358
|
+
<summary><strong>🌍 Markets Management (5 tools)</strong></summary>
|
|
359
|
+
|
|
360
|
+
| Tool | Description |
|
|
361
|
+
|------|-------------|
|
|
362
|
+
| `create-market` | Create a new market for international selling |
|
|
363
|
+
| `get-market` | Retrieve market details and configuration |
|
|
364
|
+
| `update-market` | Update market name, currency, or enabled status |
|
|
365
|
+
| `delete-market` | Delete a market by ID |
|
|
366
|
+
| `list-markets` | List all markets with pagination |
|
|
367
|
+
|
|
368
|
+
</details>
|
|
369
|
+
|
|
356
370
|
---
|
|
357
371
|
|
|
358
372
|
## 🔧 Troubleshooting
|
|
@@ -399,7 +413,7 @@ npm run inspect:config
|
|
|
399
413
|
|
|
400
414
|
MCP Inspector opens a web UI at `http://localhost:6274` where you can:
|
|
401
415
|
|
|
402
|
-
- 📋 Browse all
|
|
416
|
+
- 📋 Browse all 45 registered tools with schemas
|
|
403
417
|
- ▶️ Execute tools interactively and view results
|
|
404
418
|
- 🔍 Inspect JSON-RPC protocol messages
|
|
405
419
|
- 📊 Monitor server events in real-time
|