@anton.andrusenko/shopify-mcp-admin 0.4.1 → 0.6.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 45 powerful tools
+> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 70 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
 
-- 🛠️ **45 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, markets
+- 🛠️ **70 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, 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
@@ -121,6 +121,8 @@ Configure these scopes when creating your Custom App:
 | `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)
 
@@ -248,7 +250,7 @@ Each tool can be converted to OpenAI function format:
 
 ## 🛠️ Available Tools
 
-@anton.andrusenko/shopify-mcp-admin provides **45 tools** organized into 8 categories:
+@anton.andrusenko/shopify-mcp-admin provides **70 tools** organized into 15 categories:
 
 <details>
 <summary><strong>📦 Product Management (7 tools)</strong></summary>
@@ -266,7 +268,7 @@ Each tool can be converted to OpenAI function format:
 </details>
 
 <details>
-<summary><strong>🏷️ Metafields (3 tools)</strong></summary>
+<summary><strong>🏷️ Product Metafields (3 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
@@ -276,6 +278,42 @@ Each tool can be converted to OpenAI function format:
 
 </details>
 
+<details>
+<summary><strong>📄 Page Metafields (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get-page-metafields` | Get all metafields for a page |
+| `set-page-metafields` | Set or update metafields on a page |
+| `delete-page-metafields` | Delete specific metafields from a page |
+
+</details>
+
+<details>
+<summary><strong>📝 Blog & Article Metafields (6 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get-blog-metafields` | Get all metafields for a blog |
+| `set-blog-metafields` | Set or update metafields on a blog |
+| `delete-blog-metafields` | Delete specific metafields from a blog |
+| `get-article-metafields` | Get all metafields for an article |
+| `set-article-metafields` | Set or update metafields on an article |
+| `delete-article-metafields` | Delete specific metafields from an article |
+
+</details>
+
+<details>
+<summary><strong>📁 Collection Metafields (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get-collection-metafields` | Get all metafields for a collection |
+| `set-collection-metafields` | Set or update metafields on a collection |
+| `delete-collection-metafields` | Delete specific metafields from a collection |
+
+</details>
+
 <details>
 <summary><strong>📁 Collection Management (7 tools)</strong></summary>
 
@@ -303,13 +341,17 @@ Each tool can be converted to OpenAI function format:
 </details>
 
 <details>
-<summary><strong>🔀 URL Redirects (3 tools)</strong></summary>
+<summary><strong>🔀 URL Redirects (7 tools)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
 | `create-redirect` | Create a URL redirect (301/302) |
 | `delete-redirect` | Delete a URL redirect |
 | `list-redirects` | List all URL redirects |
+| `bulk-delete-redirects` | Delete multiple redirects by ID |
+| `bulk-delete-redirects-by-search` | Delete redirects matching a search query |
+| `import-redirects` | Import redirects from CSV URL |
+| `submit-redirect-import` | Submit a redirect import job for processing |
 
 </details>
 
@@ -367,6 +409,39 @@ Each tool can be converted to OpenAI function format:
 
 </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
@@ -413,7 +488,7 @@ npm run inspect:config
 
 MCP Inspector opens a web UI at `http://localhost:6274` where you can:
 
-- 📋 Browse all 45 registered tools with schemas
+- 📋 Browse all 70 registered tools with schemas
 - ▶️ Execute tools interactively and view results
 - 🔍 Inspect JSON-RPC protocol messages
 - 📊 Monitor server events in real-time