@anton.andrusenko/shopify-mcp-admin 0.4.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @anton.andrusenko/shopify-mcp-admin
 
-> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 40 powerful tools
+> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 54 powerful tools
 
 [![npm version](https://badge.fury.io/js/@anton.andrusenko%2Fshopify-mcp-admin.svg)](https://www.npmjs.com/package/@anton.andrusenko/shopify-mcp-admin)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -11,7 +11,7 @@
 
 ## ✨ Features
 
-- 🛠️ **40 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects
+- 🛠️ **54 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, markets, locales & translations
 - 🤖 **AI-Optimized** — Tool descriptions and error messages designed for LLM comprehension
 - 🔌 **Dual Transport** — STDIO for Claude Desktop, HTTP for ChatGPT/OpenAI
 - ⚡ **Rate Limiting** — Automatic retry with exponential backoff for Shopify API limits
@@ -120,6 +120,9 @@ Configure these scopes when creating your Custom App:
 | `read_inventory`, `write_inventory` | Inventory management |
 | `read_content`, `write_content` | Pages, blogs, articles |
 | `read_online_store_navigation`, `write_online_store_navigation` | URL redirects |
+| `read_markets`, `write_markets` | Markets (international selling) |
+| `read_locales`, `write_locales` | Shop locales and translations |
+| `read_translations`, `write_translations` | Translatable content |
 
 📖 **Setup Guide:** [Shopify Custom App Documentation](https://shopify.dev/docs/apps/tools/development-stores)
 
@@ -143,7 +146,7 @@ Edit your Claude Desktop configuration file:
   "mcpServers": {
     "shopify": {
       "command": "npx",
-      "args": ["@anton.andrusenko/shopify-mcp-admin"],
+      "args": ["-y", "@anton.andrusenko/shopify-mcp-admin"],
       "env": {
         "SHOPIFY_STORE_URL": "your-store.myshopify.com",
         "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
@@ -160,7 +163,7 @@ Edit your Claude Desktop configuration file:
   "mcpServers": {
     "shopify": {
       "command": "npx",
-      "args": ["@anton.andrusenko/shopify-mcp-admin"],
+      "args": ["-y", "@anton.andrusenko/shopify-mcp-admin"],
       "env": {
         "SHOPIFY_STORE_URL": "your-store.myshopify.com",
         "SHOPIFY_CLIENT_ID": "xxxxx",
@@ -247,7 +250,7 @@ Each tool can be converted to OpenAI function format:
 
 ## 🛠️ Available Tools
 
-@anton.andrusenko/shopify-mcp-admin provides **40 tools** organized into 7 categories:
+@anton.andrusenko/shopify-mcp-admin provides **54 tools** organized into 11 categories:
 
 <details>
 <summary><strong>📦 Product Management (7 tools)</strong></summary>
@@ -353,6 +356,52 @@ Each tool can be converted to OpenAI function format:
 
 </details>
 
+<details>
+<summary><strong>🌍 Markets Management (5 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `create-market` | Create a new market for international selling |
+| `get-market` | Retrieve market details and configuration |
+| `update-market` | Update market name, currency, or enabled status |
+| `delete-market` | Delete a market by ID |
+| `list-markets` | List all markets with pagination |
+
+</details>
+
+<details>
+<summary><strong>🌐 Web Presence Management (4 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `create-web-presence` | Create a web presence linking a market to domains/locales |
+| `update-web-presence` | Update web presence default locale or domain settings |
+| `delete-web-presence` | Delete a web presence by ID |
+| `list-web-presences` | List all web presences with market associations |
+
+</details>
+
+<details>
+<summary><strong>🗣️ Shop Locales (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `enable-shop-locale` | Enable a locale for your shop |
+| `disable-shop-locale` | Disable and unpublish a shop locale |
+| `list-shop-locales` | List all enabled shop locales |
+
+</details>
+
+<details>
+<summary><strong>🌐 Translation Management (2 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `register-translations` | Register translations for products, collections, etc. |
+| `remove-translations` | Remove translations for specific resources |
+
+</details>
+
 ---
 
 ## 🔧 Troubleshooting
@@ -399,7 +448,7 @@ npm run inspect:config
 
 MCP Inspector opens a web UI at `http://localhost:6274` where you can:
 
-- 📋 Browse all 40 registered tools with schemas
+- 📋 Browse all 54 registered tools with schemas
 - ▶️ Execute tools interactively and view results
 - 🔍 Inspect JSON-RPC protocol messages
 - 📊 Monitor server events in real-time