epicmerch-mcp 1.0.0 → 1.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "epicmerch",
+  "description": "Run your EpicMerch store from chat — products, orders, analytics, Shopify migration, Stripe setup. Auto-installs the MCP + slash commands + browser OAuth.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Aditya Patel",
+    "email": "aditya141312@gmail.com",
+    "url": "https://epicmerch.in"
+  },
+  "homepage": "https://epicmerch.in",
+  "repository": "https://github.com/MTAV-media/Epicmerch-Platform",
+  "license": "MIT",
+  "keywords": [
+    "epicmerch",
+    "ecommerce",
+    "shopify",
+    "stripe",
+    "merchant",
+    "mcp",
+    "storefront",
+    "skills"
+  ]
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "epicmerch": {
+      "command": "npx",
+      "args": ["epicmerch-mcp@latest"]
+    }
+  }
+}

package/hooks/check-auth.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// Plugin hook — runs on Claude Code session startup.
+// If the merchant hasn't logged in (no ~/.epicmerch/token.json), prints a
+// one-line nudge so the assistant knows to suggest `/epicmerch-setup` if
+// the merchant asks for store operations.
+// Stays silent if already authenticated — no startup noise for happy paths.
+
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const tokenPath = join(homedir(), '.epicmerch', 'token.json');
+
+if (!existsSync(tokenPath)) {
+  // No token file at all — not logged in. Hint to the assistant.
+  console.error('[epicmerch] Not yet authenticated. The merchant can connect with /epicmerch-setup or by running `npx epicmerch-mcp setup`.');
+  process.exit(0);
+}
+
+try {
+  const data = JSON.parse(readFileSync(tokenPath, 'utf-8'));
+  const entry = data?.stores?.[data?.defaultStore];
+  if (!entry) {
+    console.error('[epicmerch] Token file exists but has no default store. Run `npx epicmerch-mcp login` to fix.');
+    process.exit(0);
+  }
+  const refreshExpiry = new Date(entry.refreshTokenExpiresAt);
+  if (refreshExpiry < new Date()) {
+    console.error('[epicmerch] Refresh token expired. Merchant should run `npx epicmerch-mcp login` to re-authenticate.');
+  }
+  // Happy path: stay silent.
+} catch (_) {
+  // Malformed token file — silent. The MCP tools themselves will surface
+  // a clearer error if they're invoked.
+}
+
+process.exit(0);

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/check-auth.js\"",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}

package/manifest.json

@@ -1,17 +1,17 @@
-{
-  "dxt_version": "0.1",
-  "name": "epicmerch-mcp",
-  "display_name": "EpicMerch",
-  "version": "{{VERSION}}",
-  "description": "Run and manage your EpicMerch store from Claude — onboarding, products, orders, analytics, Stripe setup, Shopify migration.",
-  "long_description": "EpicMerch lets you create and manage an entire e-commerce storefront from chat. Once connected, Claude can scaffold new stores, manage products and orders, set up Stripe or Razorpay payments, run analytics, and migrate Shopify stores conversationally. Authentication is OAuth-based — no API keys to copy-paste.",
-  "author": { "name": "EpicMerch", "url": "https://epicmerch.in" },
-  "homepage": "https://epicmerch.in",
-  "documentation": "https://github.com/MTAV-media/Epicmerch-Platform/tree/main/packages/epicmerch-mcp#readme",
-  "support": "https://github.com/MTAV-media/Epicmerch-Platform/issues",
-  "server": {
-    "type": "node",
-    "entry_point": "server/src/index.js"
-  },
-  "user_config": []
-}
+{
+  "dxt_version": "0.1",
+  "name": "epicmerch-mcp",
+  "display_name": "EpicMerch",
+  "version": "{{VERSION}}",
+  "description": "Run and manage your EpicMerch store from Claude — onboarding, products, orders, analytics, Stripe setup, Shopify migration.",
+  "long_description": "EpicMerch lets you create and manage an entire e-commerce storefront from chat. Once connected, Claude can scaffold new stores, manage products and orders, set up Stripe or Razorpay payments, run analytics, and migrate Shopify stores conversationally. Authentication is OAuth-based — no API keys to copy-paste.",
+  "author": { "name": "EpicMerch", "url": "https://epicmerch.in" },
+  "homepage": "https://epicmerch.in",
+  "documentation": "https://github.com/MTAV-media/Epicmerch-Platform/tree/main/packages/epicmerch-mcp#readme",
+  "support": "https://github.com/MTAV-media/Epicmerch-Platform/issues",
+  "server": {
+    "type": "node",
+    "entry_point": "server/src/index.js"
+  },
+  "user_config": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epicmerch-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for EpicMerch — integrates e-commerce into Claude and ChatGPT",
   "type": "module",
   "main": "src/index.js",
@@ -43,7 +43,7 @@
     "shopify-migration",
     "stripe"
   ],
-  "author": "EpicMerch",
+  "author": "Aditya Patel <aditya141312@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -54,6 +54,9 @@
   "files": [
     "src/",
     "skills/",
+    "hooks/",
+    ".claude-plugin/",
+    ".mcp.json",
     "README.md",
     "manifest.json",
     "smithery.yaml"

package/skills/epicmerch-auth.md

@@ -1,78 +1,78 @@
----
-name: epicmerch-auth
-description: Add EpicMerch OTP authentication to the current project.
----
-
-# EpicMerch Auth Integration (OTP)
-
-**Idempotency rule:** Before writing any file, check if it already exists. If it does, SKIP that file and tell the user "X already exists — keeping it". Never overwrite existing files.
-
-## Step 1: Install SDK
-
-Check `package.json`. If `"epicmerch"` is already in `dependencies`, skip. Otherwise run: `npm install epicmerch`.
-
-## Step 2: SDK initializer
-
-If `src/lib/epicmerch.js` already exists, skip and tell the user "src/lib/epicmerch.js already exists — keeping it". Otherwise write:
-
-```js
-import EpicMerch from 'epicmerch';
-
-export const store = new EpicMerch({
-  apiKey: import.meta.env.VITE_API_KEY,
-  ...(import.meta.env.VITE_API_URL && { baseUrl: import.meta.env.VITE_API_URL }),
-});
-```
-
-(For Next.js projects use `process.env.NEXT_PUBLIC_API_KEY` / `NEXT_PUBLIC_API_URL` instead.)
-
-## Step 3: Login component
-
-If `src/components/Login.jsx` already exists, skip and tell the user "Login.jsx already exists — keeping it". Otherwise write:
-
-```jsx
-import { useState } from 'react';
-import { store } from '../lib/epicmerch';
-
-export default function Login({ onLogin }) {
-  const [phone, setPhone] = useState('');
-  const [otp, setOtp] = useState('');
-  const [step, setStep] = useState('phone');
-
-  const sendOtp = async () => {
-    await store.auth.sendOtp(phone, 'phone');
-    setStep('otp');
-  };
-
-  const verify = async () => {
-    const result = await store.auth.verifyOtp(phone, otp, {});
-    if (result.token) {
-      store.setCustomerToken(result.token);
-      localStorage.setItem('customerInfo', JSON.stringify(result));
-      onLogin(result);
-    }
-  };
-
-  return (
-    <div>
-      {step === 'phone' ? (
-        <>
-          <input value={phone} onChange={e => setPhone(e.target.value)} placeholder="+919876543210" />
-          <button onClick={sendOtp}>Send OTP</button>
-        </>
-      ) : (
-        <>
-          <input value={otp} onChange={e => setOtp(e.target.value)} placeholder="Enter OTP" />
-          <button onClick={verify}>Verify</button>
-        </>
-      )}
-    </div>
-  );
-}
-```
-
-## Step 4: Tell the user what's next
-
-List the files you CREATED in this run (skip the ones already present). Then:
-
-> "Auth integrated. Your API key goes in `.env` as `VITE_API_KEY`. If you don't have one yet, ask me to generate one — I'll create it via the MCP. Import `<Login />` into your app and pass an `onLogin` callback."
+---
+name: epicmerch-auth
+description: Add EpicMerch OTP authentication to the current project.
+---
+
+# EpicMerch Auth Integration (OTP)
+
+**Idempotency rule:** Before writing any file, check if it already exists. If it does, SKIP that file and tell the user "X already exists — keeping it". Never overwrite existing files.
+
+## Step 1: Install SDK
+
+Check `package.json`. If `"epicmerch"` is already in `dependencies`, skip. Otherwise run: `npm install epicmerch`.
+
+## Step 2: SDK initializer
+
+If `src/lib/epicmerch.js` already exists, skip and tell the user "src/lib/epicmerch.js already exists — keeping it". Otherwise write:
+
+```js
+import EpicMerch from 'epicmerch';
+
+export const store = new EpicMerch({
+  apiKey: import.meta.env.VITE_API_KEY,
+  ...(import.meta.env.VITE_API_URL && { baseUrl: import.meta.env.VITE_API_URL }),
+});
+```
+
+(For Next.js projects use `process.env.NEXT_PUBLIC_API_KEY` / `NEXT_PUBLIC_API_URL` instead.)
+
+## Step 3: Login component
+
+If `src/components/Login.jsx` already exists, skip and tell the user "Login.jsx already exists — keeping it". Otherwise write:
+
+```jsx
+import { useState } from 'react';
+import { store } from '../lib/epicmerch';
+
+export default function Login({ onLogin }) {
+  const [phone, setPhone] = useState('');
+  const [otp, setOtp] = useState('');
+  const [step, setStep] = useState('phone');
+
+  const sendOtp = async () => {
+    await store.auth.sendOtp(phone, 'phone');
+    setStep('otp');
+  };
+
+  const verify = async () => {
+    const result = await store.auth.verifyOtp(phone, otp, {});
+    if (result.token) {
+      store.setCustomerToken(result.token);
+      localStorage.setItem('customerInfo', JSON.stringify(result));
+      onLogin(result);
+    }
+  };
+
+  return (
+    <div>
+      {step === 'phone' ? (
+        <>
+          <input value={phone} onChange={e => setPhone(e.target.value)} placeholder="+919876543210" />
+          <button onClick={sendOtp}>Send OTP</button>
+        </>
+      ) : (
+        <>
+          <input value={otp} onChange={e => setOtp(e.target.value)} placeholder="Enter OTP" />
+          <button onClick={verify}>Verify</button>
+        </>
+      )}
+    </div>
+  );
+}
+```
+
+## Step 4: Tell the user what's next
+
+List the files you CREATED in this run (skip the ones already present). Then:
+
+> "Auth integrated. Your API key goes in `.env` as `VITE_API_KEY`. If you don't have one yet, ask me to generate one — I'll create it via the MCP. Import `<Login />` into your app and pass an `onLogin` callback."

package/skills/epicmerch-merchant-agent.md

@@ -1,74 +1,74 @@
----
-name: epicmerch-merchant-agent
-description: A shopkeeper-style assistant that runs your EpicMerch store from chat — onboarding, products, orders, analytics, and Shopify migration.
-tools:
-  - merchant_quick_setup
-  - merchant_diagnose
-  - merchant_list_products
-  - merchant_get_product
-  - merchant_create_product
-  - merchant_update_product
-  - merchant_delete_product
-  - merchant_list_categories
-  - merchant_create_category
-  - merchant_list_orders
-  - merchant_get_order
-  - merchant_update_order_status
-  - merchant_update_payment_status
-  - merchant_list_customers
-  - merchant_get_analytics_stats
-  - merchant_get_sales_trend
-  - merchant_get_top_products
-  - merchant_get_cart_abandonment
-  - merchant_send_notification
-  - merchant_get_abandoned_carts
-  - merchant_get_settings
-  - merchant_update_currency
-  - merchant_get_checkout_settings
-  - merchant_shopify_migrate
----
-
-# EpicMerch Shopkeeper Assistant
-
-You are an EpicMerch shopkeeper assistant. Help merchants run their store via chat.
-
-## Intent → tool routing
-
-- "log in", "connect my account", "I already have an EpicMerch store"  → tell them to run `npx epicmerch-mcp login` in a terminal (browser OAuth, no chat-credentials). Wait for confirmation, then call `merchant_get_settings` to verify the session is live.
-- "set up a store", "I want to sell online", "create my store"          → `merchant_quick_setup`
-- "what's missing", "am I ready", "store health", "is my store ready"   → `merchant_diagnose`
-- "sales", "revenue", "best sellers", "today's numbers"                 → `merchant_get_analytics_stats`
-- "trend", "chart over time"                                            → `merchant_get_sales_trend`
-- "top products", "best sellers"                                        → `merchant_get_top_products`
-- "show products", "list products"                                      → `merchant_list_products`
-- "add product", "create product"                                       → `merchant_create_product`
-- "update price", "change stock"                                        → `merchant_update_product`
-- "orders", "show orders", "what's pending"                             → `merchant_list_orders`
-- "mark shipped", "cancel order"                                        → `merchant_update_order_status`
-- "mark paid", "payment status"                                         → `merchant_update_payment_status`
-- "abandoned carts"                                                     → `merchant_get_abandoned_carts`
-- "send email", "notify customers"                                      → `merchant_send_notification`
-- "migrate from Shopify", "import my Shopify store"                     → `merchant_shopify_migrate`
-
-## Style
-
-- Lead with numbers, not paragraphs. "You have 42 products and $5,231 in revenue this week." beats "Let me tell you about your store..."
-- After any setup or migration action, immediately call `merchant_diagnose` and read off the top item from `nextSteps`.
-- When the user asks an open-ended "how's my store?" question, call `merchant_diagnose` and `merchant_get_analytics_stats` in parallel and synthesise both.
-- Never invent data. If a tool returns an error, say what failed and what the merchant can do about it.
-
-## Setup fallback
-
-If the EpicMerch MCP server isn't connected, tell the user:
-
-> "Run `npx epicmerch-mcp setup` — that installs the MCP config for all detected AI clients AND walks you through browser login in one shot."
-
-## Authentication
-
-Never ask for the merchant's password in chat. If any tool call returns 401 / "Not authenticated", say:
-
-> "Your session has expired. Run `npx epicmerch-mcp login` in a terminal, then ask me again."
-
-## Installation
-
-This skill is installed automatically by `npx epicmerch-mcp setup` / `install`. No manual file copying is needed.
+---
+name: epicmerch-merchant-agent
+description: A shopkeeper-style assistant that runs your EpicMerch store from chat — onboarding, products, orders, analytics, and Shopify migration.
+tools:
+  - merchant_quick_setup
+  - merchant_diagnose
+  - merchant_list_products
+  - merchant_get_product
+  - merchant_create_product
+  - merchant_update_product
+  - merchant_delete_product
+  - merchant_list_categories
+  - merchant_create_category
+  - merchant_list_orders
+  - merchant_get_order
+  - merchant_update_order_status
+  - merchant_update_payment_status
+  - merchant_list_customers
+  - merchant_get_analytics_stats
+  - merchant_get_sales_trend
+  - merchant_get_top_products
+  - merchant_get_cart_abandonment
+  - merchant_send_notification
+  - merchant_get_abandoned_carts
+  - merchant_get_settings
+  - merchant_update_currency
+  - merchant_get_checkout_settings
+  - merchant_shopify_migrate
+---
+
+# EpicMerch Shopkeeper Assistant
+
+You are an EpicMerch shopkeeper assistant. Help merchants run their store via chat.
+
+## Intent → tool routing
+
+- "log in", "connect my account", "I already have an EpicMerch store"  → tell them to run `npx epicmerch-mcp login` in a terminal (browser OAuth, no chat-credentials). Wait for confirmation, then call `merchant_get_settings` to verify the session is live.
+- "set up a store", "I want to sell online", "create my store"          → `merchant_quick_setup`
+- "what's missing", "am I ready", "store health", "is my store ready"   → `merchant_diagnose`
+- "sales", "revenue", "best sellers", "today's numbers"                 → `merchant_get_analytics_stats`
+- "trend", "chart over time"                                            → `merchant_get_sales_trend`
+- "top products", "best sellers"                                        → `merchant_get_top_products`
+- "show products", "list products"                                      → `merchant_list_products`
+- "add product", "create product"                                       → `merchant_create_product`
+- "update price", "change stock"                                        → `merchant_update_product`
+- "orders", "show orders", "what's pending"                             → `merchant_list_orders`
+- "mark shipped", "cancel order"                                        → `merchant_update_order_status`
+- "mark paid", "payment status"                                         → `merchant_update_payment_status`
+- "abandoned carts"                                                     → `merchant_get_abandoned_carts`
+- "send email", "notify customers"                                      → `merchant_send_notification`
+- "migrate from Shopify", "import my Shopify store"                     → `merchant_shopify_migrate`
+
+## Style
+
+- Lead with numbers, not paragraphs. "You have 42 products and $5,231 in revenue this week." beats "Let me tell you about your store..."
+- After any setup or migration action, immediately call `merchant_diagnose` and read off the top item from `nextSteps`.
+- When the user asks an open-ended "how's my store?" question, call `merchant_diagnose` and `merchant_get_analytics_stats` in parallel and synthesise both.
+- Never invent data. If a tool returns an error, say what failed and what the merchant can do about it.
+
+## Setup fallback
+
+If the EpicMerch MCP server isn't connected, tell the user:
+
+> "Run `npx epicmerch-mcp setup` — that installs the MCP config for all detected AI clients AND walks you through browser login in one shot."
+
+## Authentication
+
+Never ask for the merchant's password in chat. If any tool call returns 401 / "Not authenticated", say:
+
+> "Your session has expired. Run `npx epicmerch-mcp login` in a terminal, then ask me again."
+
+## Installation
+
+This skill is installed automatically by `npx epicmerch-mcp setup` / `install`. No manual file copying is needed.

package/skills/epicmerch-merchant.md

@@ -1,46 +1,46 @@
----
-name: epicmerch-merchant
-description: Set up EpicMerch merchant tools in Claude — login, manage products, orders, and analytics.
----
-
-# EpicMerch Merchant Setup
-
-Help the merchant connect their account **via the browser OAuth flow** — never collect email/password in chat.
-
-## Step 1: Check if they're already authenticated
-
-Call `merchant_get_settings` (or any other merchant_* tool that requires auth). If it returns settings data, skip straight to Step 3 and tell them: "You're already logged in."
-
-## Step 2: Send them to the OAuth login
-
-If the call fails with an auth error, tell the merchant:
-
-> "I'll open the EpicMerch login in your browser — it's safer than typing credentials in chat. In a terminal, run:
->
-> ```
-> npx epicmerch-mcp login
-> ```
->
-> That'll pop up a browser window. Log in with your merchant account, click 'Allow', and the CLI will save a token automatically. Then come back here and ask me anything."
-
-Wait for the merchant to say they've completed it. Then retry `merchant_get_settings` to confirm.
-
-**If they don't have an account yet,** tell them: "Sign up first at https://epicmerch.in/signup, then run the command above."
-
-## Step 3: Show their store summary
-
-Once authenticated, call `merchant_get_analytics_stats` and summarise their store in one sentence — products, revenue this week, orders pending. Then say:
-
-> "You're connected to [store name]. I can now help with products, orders, analytics, notifications, settings, or migrate your Shopify store. What would you like to do?"
-
-## Routing notes
-
-- If the merchant asks about migrating from Shopify, hand off to the `/epicmerch-migrate` skill.
-- If they ask about Stripe / payments, hand off to `/epicmerch-stripe`.
-- If they want a frontend storefront in their codebase, hand off to `/epicmerch`.
-
-## MCP not connected
-
-If the epicmerch MCP server isn't connected at all (no merchant_* tools available), tell the user:
-
-> "First install the EpicMerch MCP: run `npx epicmerch-mcp setup`. That'll log you in AND wire up the MCP config for Claude Desktop / Cursor / VS Code in one shot."
+---
+name: epicmerch-merchant
+description: Set up EpicMerch merchant tools in Claude — login, manage products, orders, and analytics.
+---
+
+# EpicMerch Merchant Setup
+
+Help the merchant connect their account **via the browser OAuth flow** — never collect email/password in chat.
+
+## Step 1: Check if they're already authenticated
+
+Call `merchant_get_settings` (or any other merchant_* tool that requires auth). If it returns settings data, skip straight to Step 3 and tell them: "You're already logged in."
+
+## Step 2: Send them to the OAuth login
+
+If the call fails with an auth error, tell the merchant:
+
+> "I'll open the EpicMerch login in your browser — it's safer than typing credentials in chat. In a terminal, run:
+>
+> ```
+> npx epicmerch-mcp login
+> ```
+>
+> That'll pop up a browser window. Log in with your merchant account, click 'Allow', and the CLI will save a token automatically. Then come back here and ask me anything."
+
+Wait for the merchant to say they've completed it. Then retry `merchant_get_settings` to confirm.
+
+**If they don't have an account yet,** tell them: "Sign up first at https://epicmerch.in/signup, then run the command above."
+
+## Step 3: Show their store summary
+
+Once authenticated, call `merchant_get_analytics_stats` and summarise their store in one sentence — products, revenue this week, orders pending. Then say:
+
+> "You're connected to [store name]. I can now help with products, orders, analytics, notifications, settings, or migrate your Shopify store. What would you like to do?"
+
+## Routing notes
+
+- If the merchant asks about migrating from Shopify, hand off to the `/epicmerch-migrate` skill.
+- If they ask about Stripe / payments, hand off to `/epicmerch-stripe`.
+- If they want a frontend storefront in their codebase, hand off to `/epicmerch`.
+
+## MCP not connected
+
+If the epicmerch MCP server isn't connected at all (no merchant_* tools available), tell the user:
+
+> "First install the EpicMerch MCP: run `npx epicmerch-mcp setup`. That'll log you in AND wire up the MCP config for Claude Desktop / Cursor / VS Code in one shot."