@anton.andrusenko/shopify-mcp-admin 0.4.1 → 0.5.0
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 +39 -4
- package/dist/index.js +1159 -13
- package/package.json +2 -2
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 54 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
|
+
- 🛠️ **54 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, markets, locales & translations
|
|
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
|
|
@@ -121,6 +121,8 @@ Configure these scopes when creating your Custom App:
|
|
|
121
121
|
| `read_content`, `write_content` | Pages, blogs, articles |
|
|
122
122
|
| `read_online_store_navigation`, `write_online_store_navigation` | URL redirects |
|
|
123
123
|
| `read_markets`, `write_markets` | Markets (international selling) |
|
|
124
|
+
| `read_locales`, `write_locales` | Shop locales and translations |
|
|
125
|
+
| `read_translations`, `write_translations` | Translatable content |
|
|
124
126
|
|
|
125
127
|
📖 **Setup Guide:** [Shopify Custom App Documentation](https://shopify.dev/docs/apps/tools/development-stores)
|
|
126
128
|
|
|
@@ -248,7 +250,7 @@ Each tool can be converted to OpenAI function format:
|
|
|
248
250
|
|
|
249
251
|
## 🛠️ Available Tools
|
|
250
252
|
|
|
251
|
-
@anton.andrusenko/shopify-mcp-admin provides **
|
|
253
|
+
@anton.andrusenko/shopify-mcp-admin provides **54 tools** organized into 11 categories:
|
|
252
254
|
|
|
253
255
|
<details>
|
|
254
256
|
<summary><strong>📦 Product Management (7 tools)</strong></summary>
|
|
@@ -367,6 +369,39 @@ Each tool can be converted to OpenAI function format:
|
|
|
367
369
|
|
|
368
370
|
</details>
|
|
369
371
|
|
|
372
|
+
<details>
|
|
373
|
+
<summary><strong>🌐 Web Presence Management (4 tools)</strong></summary>
|
|
374
|
+
|
|
375
|
+
| Tool | Description |
|
|
376
|
+
|------|-------------|
|
|
377
|
+
| `create-web-presence` | Create a web presence linking a market to domains/locales |
|
|
378
|
+
| `update-web-presence` | Update web presence default locale or domain settings |
|
|
379
|
+
| `delete-web-presence` | Delete a web presence by ID |
|
|
380
|
+
| `list-web-presences` | List all web presences with market associations |
|
|
381
|
+
|
|
382
|
+
</details>
|
|
383
|
+
|
|
384
|
+
<details>
|
|
385
|
+
<summary><strong>🗣️ Shop Locales (3 tools)</strong></summary>
|
|
386
|
+
|
|
387
|
+
| Tool | Description |
|
|
388
|
+
|------|-------------|
|
|
389
|
+
| `enable-shop-locale` | Enable a locale for your shop |
|
|
390
|
+
| `disable-shop-locale` | Disable and unpublish a shop locale |
|
|
391
|
+
| `list-shop-locales` | List all enabled shop locales |
|
|
392
|
+
|
|
393
|
+
</details>
|
|
394
|
+
|
|
395
|
+
<details>
|
|
396
|
+
<summary><strong>🌐 Translation Management (2 tools)</strong></summary>
|
|
397
|
+
|
|
398
|
+
| Tool | Description |
|
|
399
|
+
|------|-------------|
|
|
400
|
+
| `register-translations` | Register translations for products, collections, etc. |
|
|
401
|
+
| `remove-translations` | Remove translations for specific resources |
|
|
402
|
+
|
|
403
|
+
</details>
|
|
404
|
+
|
|
370
405
|
---
|
|
371
406
|
|
|
372
407
|
## 🔧 Troubleshooting
|
|
@@ -413,7 +448,7 @@ npm run inspect:config
|
|
|
413
448
|
|
|
414
449
|
MCP Inspector opens a web UI at `http://localhost:6274` where you can:
|
|
415
450
|
|
|
416
|
-
- 📋 Browse all
|
|
451
|
+
- 📋 Browse all 54 registered tools with schemas
|
|
417
452
|
- ▶️ Execute tools interactively and view results
|
|
418
453
|
- 🔍 Inspect JSON-RPC protocol messages
|
|
419
454
|
- 📊 Monitor server events in real-time
|