@anton.andrusenko/shopify-mcp-admin 0.6.0 → 0.8.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 70 powerful tools
+> 🛍️ **MCP Server for Shopify Admin API** — Enable AI agents to manage Shopify stores with 79 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
 
-- 🛠️ **70 MCP Tools** — Complete store management: products, inventory, collections, pages, blogs, redirects, metafields, markets, locales & translations
+- 🛠️ **79 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
@@ -250,7 +250,62 @@ Each tool can be converted to OpenAI function format:
 
 ## 🛠️ Available Tools
 
-@anton.andrusenko/shopify-mcp-admin provides **70 tools** organized into 15 categories:
+@anton.andrusenko/shopify-mcp-admin provides **79 tools** organized into 16 categories:
+
+<details>
+<summary><strong>🏪 Store Info (9 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get-store-info` | Get basic store information (name, domain, plan, currency, timezone, email) |
+| `get-store-limits` | Get store resource limits (max variants, max options, location limit) |
+| `get-store-features` | Get feature flags (gift cards, reports, storefront, bundles, subscriptions) |
+| `get-store-currencies` | Get multi-currency configuration (base currency, presentment currencies, formats) |
+| `get-store-shipping` | Get shipping configuration (ships-to countries, countries in shipping zones) |
+| `get-store-domain` | Get primary domain configuration (hostname, URL, SSL status) |
+| `get-store-taxes` | Get tax configuration (taxes included in prices, tax shipping) |
+| `get-store-policies` | Get legal policies (privacy, terms of service, refund policy) |
+| `get-store-alerts` | Get admin alerts and setup requirements |
+
+#### Example: Get Store Limits
+
+```json
+{
+  "maxProductVariants": 2000,
+  "maxProductOptions": 3,
+  "locationLimit": 1000,
+  "redirectLimitReached": false
+}
+```
+
+#### Example: Get Store Features
+
+```json
+{
+  "giftCards": true,
+  "reports": true,
+  "storefront": true,
+  "bundles": {
+    "eligibleForBundles": true
+  },
+  "sellsSubscriptions": false
+}
+```
+
+#### Example: Get Store Currencies
+
+```json
+{
+  "currencyCode": "USD",
+  "enabledPresentmentCurrencies": ["USD", "EUR", "GBP", "CAD"],
+  "currencyFormats": {
+    "moneyFormat": "${{amount}}",
+    "moneyWithCurrencyFormat": "${{amount}} USD"
+  }
+}
+```
+
+</details>
 
 <details>
 <summary><strong>📦 Product Management (7 tools)</strong></summary>
@@ -488,13 +543,38 @@ npm run inspect:config
 
 MCP Inspector opens a web UI at `http://localhost:6274` where you can:
 
-- 📋 Browse all 70 registered tools with schemas
+- 📋 Browse all 79 registered tools with schemas
+- 📊 Access 9 MCP resources for store context
 - ▶️ Execute tools interactively and view results
 - 🔍 Inspect JSON-RPC protocol messages
 - 📊 Monitor server events in real-time
 
 > **Tip:** Use `npm run inspect:dev` during development for instant feedback without rebuilding.
 
+---
+
+## 📊 MCP Resources
+
+The MCP server exposes comprehensive store context information via MCP resources. These are read-only data sources that AI agents can query for context.
+
+### Extended Store Resources
+
+| Resource URI | Description |
+|--------------|-------------|
+| `shopify://store/info` | Basic store info (name, domain, plan, currency, timezone) |
+| `shopify://store/limits` | Resource limits (max variants, max options, location limit) |
+| `shopify://store/features` | Feature flags (gift cards, reports, storefront, bundles) |
+| `shopify://store/currencies` | Multi-currency configuration (base currency, presentment currencies) |
+| `shopify://store/shipping` | Shipping configuration (ships-to countries, shipping zones) |
+| `shopify://store/domain` | Primary domain configuration (hostname, URL, SSL status) |
+| `shopify://store/taxes` | Tax configuration (taxes included, tax shipping) |
+| `shopify://store/policies` | Legal policies (privacy, terms of service, refund) |
+| `shopify://store/alerts` | Admin alerts and setup requirements |
+
+> **Note:** For MCP clients that don't support resources (e.g., Claude Desktop), equivalent tools are available. See **Store Info Tools** below.
+
+---
+
 ### FAQ
 
 **Q: Can I connect to multiple stores?**