@wisewandtools/mcp-server 2.0.0 → 2.0.2

package/README.md

@@ -30,19 +30,58 @@ Production-ready Model Context Protocol (MCP) server for Wisewand API, enabling
 - **Node.js 20+** (check with `node --version`)
 - **npm** (comes with Node.js)
 - **Wisewand API key** ([Get yours here](https://wisewand.ai))
-- **Claude Desktop** (for using with Claude AI)
+- **Claude Desktop or Claude Code CLI**
 
-### NPM Installation (Easiest) ⭐
+### Installation Methods
 
-Install globally via npm:
+#### Option 1: Claude CLI (Easiest) ⭐
+
+For **Claude Code CLI** users, just run this **ONE COMMAND** in your project directory:
 
 ```bash
-npm install -g @wisewand/mcp-server
+claude mcp add wisewand -- npx -y @wisewandtools/mcp-server
+```
+
+When prompted, enter your Wisewand API key (starts with `sk_live_` or `sk_test_`).
+
+**That's it!** The server will:
+- ✅ Validate your API key format
+- ✅ Test connectivity to Wisewand API
+- ✅ Create project-level `.claude/config.json`
+- ✅ Start automatically when you restart Claude
+
+**Common Installation Errors:**
+
+If you see an error, here's what it means:
+
 ```
+❌ FATAL: WISEWAND_API_KEY environment variable not set
+```
+**Fix:** Make sure you entered your API key when prompted, or use the `-e` flag (see below).
 
-Or use with **npx** (no installation needed - recommended):
+```
+❌ FATAL: WISEWAND_API_KEY has invalid format
+   Expected: sk_live_... or sk_test_...
+```
+**Fix:** Check your API key at [wisewand.ai/dashboard/api-keys](https://wisewand.ai/dashboard/api-keys). It must start with `sk_live_` or `sk_test_`.
 
-#### Configure Claude Desktop
+```
+❌ FATAL: Cannot connect to Wisewand API
+   Reason: fetch failed
+```
+**Fix:** Check your internet connection and verify your API key is valid and active.
+
+**Alternative: Pass API key directly** (skips prompt):
+
+```bash
+claude mcp add -e WISEWAND_API_KEY=sk_live_YOUR_KEY_HERE wisewand -- npx -y @wisewandtools/mcp-server
+```
+
+> 💡 **Note:** The `--` separator is required to pass arguments to the npx command.
+
+---
+
+#### Option 2: Claude Desktop (Manual Config)
 
 **Find your configuration file:**
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
@@ -56,7 +95,7 @@ Or use with **npx** (no installation needed - recommended):
   "mcpServers": {
     "wisewand": {
       "command": "npx",
-      "args": ["-y", "@wisewand/mcp-server"],
+      "args": ["-y", "@wisewandtools/mcp-server"],
       "env": {
         "WISEWAND_API_KEY": "sk_live_YOUR_API_KEY_HERE"
       }
@@ -69,6 +108,22 @@ Or use with **npx** (no installation needed - recommended):
 
 > 💡 **Tip**: With npx, the package is always downloaded fresh, so you automatically get the latest version.
 
+### 🎓 First Time Using Wisewand? Start with the Onboarding Wizard!
+
+After restarting Claude, ask Claude:
+
+```
+Use the onboarding wizard
+```
+
+This **interactive guide** will teach you:
+- ✅ What all 74 tools can do (organized into 7 easy categories)
+- ✅ How to create your first article step-by-step (with actual JSON examples)
+- ✅ 5 powerful real-world workflows (SEO series, product reviews, multi-language, etc.)
+- ✅ Best practices for quality, SEO optimization, and cost management
+
+**Takes 10-15 minutes and you'll be a Wisewand expert!**
+
 ---
 
 ### Local Installation (For Development)

package/dist/index.d.ts

@@ -312,6 +312,14 @@ declare class WisewandMCPServer {
     getPromptCount(): number;
     getHealth(): HealthStatus | null;
     getMetrics(): Promise<string>;
+    /**
+     * Test API connection during startup
+     * Returns {ok: boolean, error?: string}
+     */
+    testAPIConnection(): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
 }
 
 export { WisewandMCPServer };