mcp-wordpress 3.0.1 → 3.1.1

package/README.md

@@ -102,7 +102,7 @@ Response: "✅ Authentication successful! Connected to: Your Site Name"
 2. **Install**: Claude Desktop → Extensions → Install → Select DXT file
 3. **Configure**: Enter your WordPress site URL and credentials
 
-✅ **Zero command line required** ✅ **Automatic updates** ✅ **Built-in security**
+✅ **Zero command line required** ✅ **Easy updates** ✅ **Built-in security**
 
 **[📖 Complete DXT Setup Guide →](docs/integrations/claude-desktop.md)**
 

package/dist/tools/index.d.ts

@@ -7,6 +7,7 @@ export { default as PerformanceTools } from "./performance.js";
 export { default as PostTools } from "./posts.js";
 export { default as SEOTools } from "./seo/index.js";
 export { default as SiteTools } from "./site.js";
+export { default as SystemTools } from "./system.js";
 export { default as TaxonomyTools } from "./taxonomies.js";
 export { default as UserTools } from "./users.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/index.js

@@ -7,6 +7,7 @@ export { default as PerformanceTools } from "./performance.js";
 export { default as PostTools } from "./posts.js";
 export { default as SEOTools } from "./seo/index.js";
 export { default as SiteTools } from "./site.js";
+export { default as SystemTools } from "./system.js";
 export { default as TaxonomyTools } from "./taxonomies.js";
 export { default as UserTools } from "./users.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/system.d.ts

@@ -0,0 +1,22 @@
+/**
+ * System Tools
+ *
+ * Provides system-level utilities like version checking
+ */
+import { WordPressClient } from "../client/api.js";
+export default class SystemTools {
+    getTools(): {
+        name: string;
+        description: string | undefined;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        handler: (_client: WordPressClient, args: Record<string, unknown>) => Promise<string>;
+    }[];
+}
+//# sourceMappingURL=system.d.ts.map

package/dist/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,QAAQ;;;;;;;;;;;2BAMuB,eAAe,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;CAM9E"}

package/dist/tools/system.js

@@ -0,0 +1,21 @@
+/**
+ * System Tools
+ *
+ * Provides system-level utilities like version checking
+ */
+import { CHECK_VERSION_TOOL, handleCheckVersion } from "./version.js";
+export default class SystemTools {
+    getTools() {
+        return [
+            {
+                name: CHECK_VERSION_TOOL.name,
+                description: CHECK_VERSION_TOOL.description,
+                inputSchema: CHECK_VERSION_TOOL.inputSchema,
+                handler: async (_client, args) => {
+                    return await handleCheckVersion(args);
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,QAAQ;QACN,OAAO;YACL;gBACE,IAAI,EAAE,kBAAkB,CAAC,IAAI;gBAC7B,WAAW,EAAE,kBAAkB,CAAC,WAAW;gBAC3C,WAAW,EAAE,kBAAkB,CAAC,WAAW;gBAC3C,OAAO,EAAE,KAAK,EAAE,OAAwB,EAAE,IAA6B,EAAE,EAAE;oBACzE,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Version Check Tool
+ *
+ * Checks if a newer version of mcp-wordpress is available on GitHub
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const CHECK_VERSION_TOOL: Tool;
+/**
+ * Handler for wp_check_version tool
+ */
+export declare function handleCheckVersion(args: unknown): Promise<string>;
+//# sourceMappingURL=version.d.ts.map

package/dist/tools/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAS1D,eAAO,MAAM,kBAAkB,EAAE,IAahC,CAAC;AAmEF;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DvE"}

package/dist/tools/version.js

@@ -0,0 +1,135 @@
+/**
+ * Version Check Tool
+ *
+ * Checks if a newer version of mcp-wordpress is available on GitHub
+ */
+import { z } from "zod";
+import { readFileSync } from "fs";
+import { join } from "path";
+const CheckVersionArgsSchema = z.object({
+    current_version: z.string().optional().describe("Override current version for testing"),
+});
+export const CHECK_VERSION_TOOL = {
+    name: "wp_check_version",
+    description: "Check if a newer version of mcp-wordpress is available. Returns current version, latest version, and download URL if update is available.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            current_version: {
+                type: "string",
+                description: "Override current version for testing (optional)",
+            },
+        },
+    },
+};
+/**
+ * Get the current version from package.json
+ */
+function getCurrentVersion() {
+    try {
+        const packageJsonPath = join(__dirname, "..", "..", "package.json");
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        return packageJson.version;
+    }
+    catch (_error) {
+        return "unknown";
+    }
+}
+/**
+ * Compare semantic versions
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1, v2) {
+    const clean1 = v1.replace(/^v/, "");
+    const clean2 = v2.replace(/^v/, "");
+    const parts1 = clean1.split(".").map(Number);
+    const parts2 = clean2.split(".").map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+        const part1 = parts1[i] || 0;
+        const part2 = parts2[i] || 0;
+        if (part1 > part2)
+            return 1;
+        if (part1 < part2)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Fetch latest release from GitHub
+ */
+async function getLatestRelease() {
+    try {
+        const response = await fetch("https://api.github.com/repos/docdyhr/mcp-wordpress/releases/latest", {
+            headers: {
+                Accept: "application/vnd.github.v3+json",
+                "User-Agent": "mcp-wordpress-server",
+            },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        return (await response.json());
+    }
+    catch (_error) {
+        return null;
+    }
+}
+/**
+ * Handler for wp_check_version tool
+ */
+export async function handleCheckVersion(args) {
+    try {
+        const parsed = CheckVersionArgsSchema.parse(args);
+        // Get current version
+        const currentVersion = parsed.current_version || getCurrentVersion();
+        if (currentVersion === "unknown") {
+            return "❌ Unable to determine current version. Package.json not found.";
+        }
+        // Fetch latest release from GitHub
+        const latestRelease = await getLatestRelease();
+        if (!latestRelease) {
+            return `ℹ️  Unable to check for updates (GitHub API unavailable).\n\nCurrent version: ${currentVersion}\n\nManually check: https://github.com/docdyhr/mcp-wordpress/releases`;
+        }
+        const latestVersion = latestRelease.tag_name.replace(/^v/, "");
+        const comparison = compareVersions(currentVersion, latestVersion);
+        if (comparison === 0) {
+            return `✅ **You're up to date!**\n\nCurrent version: v${currentVersion}\nLatest version: v${latestVersion}\n\nNo update needed.`;
+        }
+        if (comparison > 0) {
+            return `🔬 **You're running a pre-release version**\n\nCurrent version: v${currentVersion}\nLatest stable: v${latestVersion}\n\nYou're ahead of the latest stable release.`;
+        }
+        // Update available
+        const dxtUrl = `https://github.com/docdyhr/mcp-wordpress/releases/download/v${latestVersion}/mcp-wordpress.dxt`;
+        let releaseNotes = "";
+        if (latestRelease.body) {
+            // Extract first 500 characters of release notes
+            const notes = latestRelease.body.substring(0, 500);
+            releaseNotes = `\n\n**What's New:**\n${notes}${latestRelease.body.length > 500 ? "..." : ""}`;
+        }
+        return `🎉 **Update Available!**
+
+**Current version:** v${currentVersion}
+**Latest version:** v${latestVersion}
+**Released:** ${new Date(latestRelease.published_at).toLocaleDateString()}
+
+**Download Links:**
+- DXT Package: ${dxtUrl}
+- Release Page: ${latestRelease.html_url}
+
+**Update Instructions:**
+1. Backup your configuration (if using multi-site)
+2. Uninstall current version from Claude Desktop
+3. Download the new DXT package
+4. Install in Claude Desktop → Extensions
+5. Restore your configuration
+
+**Documentation:** https://github.com/docdyhr/mcp-wordpress/blob/main/docs/DXT_UPDATE_GUIDE.md${releaseNotes}`;
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            return `❌ Invalid arguments: ${error.issues.map((e) => e.message).join(", ")}`;
+        }
+        return `❌ Error checking version: ${error instanceof Error ? error.message : "Unknown error"}`;
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/tools/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"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"}

package/docs/DXT_UPDATE_GUIDE.md

@@ -0,0 +1,220 @@
+# DXT Package Update Guide
+
+**Important**: Claude Desktop does **NOT** automatically update DXT packages. You must manually update to get the latest features and fixes.
+
+---
+
+## 📋 Table of Contents
+
+- [Why Manual Updates?](#why-manual-updates)
+- [How to Check Your Version](#how-to-check-your-version)
+- [Update Process](#update-process)
+- [Update Notification Tool](#update-notification-tool)
+- [What's New in v3.0.0](#whats-new-in-v300)
+
+---
+
+## Why Manual Updates?
+
+DXT packages in Claude Desktop require manual updates because:
+
+1. **No Auto-Update Mechanism**: Claude Desktop doesn't currently support automatic DXT updates
+2. **User Control**: You decide when to update (important for stability)
+3. **Configuration Preservation**: Manual updates let you backup configs first
+
+---
+
+## How to Check Your Version
+
+### Method 1: Check in Claude Desktop
+
+Ask Claude:
+```
+What version of mcp-wordpress are you running?
+```
+
+Claude will respond with the current version number.
+
+### Method 2: Check Manifest File
+
+The DXT package is installed at:
+```
+~/Library/Application Support/Claude/Claude Extensions/local.dxt.thomas-dyhr.mcp-wordpress/manifest.json
+```
+
+Open this file and look for the `version` field.
+
+### Method 3: Check Logs
+
+View the server logs:
+```bash
+tail -50 ~/Library/Logs/Claude/mcp-server-WordPress\ MCP\ Server.log
+```
+
+The version is shown when the server starts.
+
+---
+
+## Update Process
+
+### Step 1: Backup Your Configuration
+
+If you're using multi-site configuration:
+
+```bash
+# Find your DXT installation directory
+cd ~/Library/Application\ Support/Claude/Claude\ Extensions/local.dxt.thomas-dyhr.mcp-wordpress/
+
+# Backup your config file (if it exists)
+cp mcp-wordpress.config.json ~/mcp-wordpress.config.json.backup
+```
+
+### Step 2: Download Latest Version
+
+Visit the releases page:
+https://github.com/docdyhr/mcp-wordpress/releases/latest
+
+Download: `mcp-wordpress.dxt`
+
+### Step 3: Uninstall Old Version
+
+1. Open **Claude Desktop**
+2. Go to **Settings** → **Extensions**
+3. Find **WordPress MCP Server**
+4. Click **Uninstall** or **Remove**
+
+### Step 4: Install New Version
+
+1. In Claude Desktop, go to **Settings** → **Extensions**
+2. Click **Install Extension** or **Add Extension**
+3. Select the downloaded `mcp-wordpress.dxt` file
+4. Follow the configuration wizard
+
+**Single-Site**: Enter your WordPress credentials in the UI
+
+**Multi-Site**: Skip the wizard, then copy your backed-up config:
+```bash
+cp ~/mcp-wordpress.config.json.backup ~/Library/Application\ Support/Claude/Claude\ Extensions/local.dxt.thomas-dyhr.mcp-wordpress/mcp-wordpress.config.json
+```
+
+### Step 5: Restart Claude Desktop
+
+Completely quit and relaunch Claude Desktop to load the new version.
+
+### Step 6: Verify Update
+
+Ask Claude:
+```
+What version of mcp-wordpress are you running?
+```
+
+It should report the new version number.
+
+---
+
+## Update Notification Tool
+
+The MCP WordPress server includes a version check tool that compares your installed version with the latest GitHub release.
+
+### Using the Version Check Tool
+
+Ask Claude:
+```
+Check if there's a new version of mcp-wordpress available
+```
+
+Or use the tool directly:
+```
+wp_check_version
+```
+
+**Response Example**:
+```
+✅ You're up to date! (v3.0.0)
+
+or
+
+⚠️  Update available!
+Current version: v2.12.0
+Latest version: v3.0.0
+Download: https://github.com/docdyhr/mcp-wordpress/releases/tag/v3.0.0
+```
+
+---
+
+## What's New in v3.0.0
+
+### 🚀 Features
+- Circuit breaker pattern for improved resilience
+- Deprecation documentation for API lifecycle management
+
+### 🐛 Security & Bug Fixes
+- Resolved CodeQL security warnings
+- Fixed js-yaml vulnerability
+- Updated MCP SDK and body-parser dependencies
+- Fixed flaky tests in env-loading, logger, and timing
+
+### ♻️ Refactoring
+- Migrated to path aliases (improved maintainability)
+- Modularized api.ts and performance.ts
+- Extracted SecurityCIPipeline into modular components
+
+### 📚 Documentation
+- Added sprint implementation documentation
+- Removed Smithery references
+- Updated README with v2.12.0+ features
+
+**Full Changelog**: https://github.com/docdyhr/mcp-wordpress/blob/main/CHANGELOG.md
+
+---
+
+## Troubleshooting
+
+### "Extension not found after update"
+
+1. Make sure you completely quit Claude Desktop (not just close window)
+2. On macOS, use Cmd+Q to fully quit
+3. Relaunch Claude Desktop
+
+### "Configuration lost after update"
+
+If you forgot to backup your config:
+
+1. Check if the old installation directory still exists:
+   ```bash
+   ls ~/Library/Application\ Support/Claude/Claude\ Extensions/
+   ```
+2. Look for directories with older version numbers
+3. Copy the config file from there
+
+### "Server won't start after update"
+
+1. Check the logs:
+   ```bash
+   tail -100 ~/Library/Logs/Claude/mcp-server-WordPress\ MCP\ Server.log
+   ```
+2. Look for error messages
+3. If you see authentication errors, reconfigure your credentials
+
+---
+
+## Best Practices
+
+1. **Check for Updates Monthly**: Visit the releases page regularly
+2. **Read Release Notes**: Understand what's changed before updating
+3. **Backup Configs**: Always backup before uninstalling
+4. **Test After Update**: Verify your sites still work after updating
+5. **Report Issues**: If something breaks, open a GitHub issue
+
+---
+
+## Need Help?
+
+- 📖 **Documentation**: https://github.com/docdyhr/mcp-wordpress
+- 🐛 **Issues**: https://github.com/docdyhr/mcp-wordpress/issues
+- 💬 **Discussions**: https://github.com/docdyhr/mcp-wordpress/discussions
+
+---
+
+**Last Updated**: 2026-01-08
+**Current Version**: 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-wordpress",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "description": "Comprehensive Model Context Protocol server for WordPress management with composition-based architecture, 59 tools, SEO toolkit, performance monitoring, intelligent caching, and production-ready authentication",
   "keywords": [
     "mcp",

package/src/tools/index.ts

@@ -7,5 +7,6 @@ export { default as PerformanceTools } from "./performance.js";
 export { default as PostTools } from "./posts.js";
 export { default as SEOTools } from "./seo/index.js";
 export { default as SiteTools } from "./site.js";
+export { default as SystemTools } from "./system.js";
 export { default as TaxonomyTools } from "./taxonomies.js";
 export { default as UserTools } from "./users.js";

package/src/tools/system.ts

@@ -0,0 +1,23 @@
+/**
+ * System Tools
+ *
+ * Provides system-level utilities like version checking
+ */
+
+import { WordPressClient } from "@/client/api.js";
+import { CHECK_VERSION_TOOL, handleCheckVersion } from "./version.js";
+
+export default class SystemTools {
+  getTools() {
+    return [
+      {
+        name: CHECK_VERSION_TOOL.name,
+        description: CHECK_VERSION_TOOL.description,
+        inputSchema: CHECK_VERSION_TOOL.inputSchema,
+        handler: async (_client: WordPressClient, args: Record<string, unknown>) => {
+          return await handleCheckVersion(args);
+        },
+      },
+    ];
+  }
+}

package/src/tools/version.ts

@@ -0,0 +1,162 @@
+/**
+ * Version Check Tool
+ *
+ * Checks if a newer version of mcp-wordpress is available on GitHub
+ */
+
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { readFileSync } from "fs";
+import { join } from "path";
+
+const CheckVersionArgsSchema = z.object({
+  current_version: z.string().optional().describe("Override current version for testing"),
+});
+
+export const CHECK_VERSION_TOOL: Tool = {
+  name: "wp_check_version",
+  description:
+    "Check if a newer version of mcp-wordpress is available. Returns current version, latest version, and download URL if update is available.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      current_version: {
+        type: "string",
+        description: "Override current version for testing (optional)",
+      },
+    },
+  },
+};
+
+interface GitHubRelease {
+  tag_name: string;
+  name: string;
+  html_url: string;
+  published_at: string;
+  body: string;
+}
+
+/**
+ * Get the current version from package.json
+ */
+function getCurrentVersion(): string {
+  try {
+    const packageJsonPath = join(__dirname, "..", "..", "package.json");
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    return packageJson.version;
+  } catch (_error) {
+    return "unknown";
+  }
+}
+
+/**
+ * Compare semantic versions
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1: string, v2: string): number {
+  const clean1 = v1.replace(/^v/, "");
+  const clean2 = v2.replace(/^v/, "");
+
+  const parts1 = clean1.split(".").map(Number);
+  const parts2 = clean2.split(".").map(Number);
+
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const part1 = parts1[i] || 0;
+    const part2 = parts2[i] || 0;
+
+    if (part1 > part2) return 1;
+    if (part1 < part2) return -1;
+  }
+
+  return 0;
+}
+
+/**
+ * Fetch latest release from GitHub
+ */
+async function getLatestRelease(): Promise<GitHubRelease | null> {
+  try {
+    const response = await fetch("https://api.github.com/repos/docdyhr/mcp-wordpress/releases/latest", {
+      headers: {
+        Accept: "application/vnd.github.v3+json",
+        "User-Agent": "mcp-wordpress-server",
+      },
+    });
+
+    if (!response.ok) {
+      return null;
+    }
+
+    return (await response.json()) as GitHubRelease;
+  } catch (_error) {
+    return null;
+  }
+}
+
+/**
+ * Handler for wp_check_version tool
+ */
+export async function handleCheckVersion(args: unknown): Promise<string> {
+  try {
+    const parsed = CheckVersionArgsSchema.parse(args);
+
+    // Get current version
+    const currentVersion = parsed.current_version || getCurrentVersion();
+
+    if (currentVersion === "unknown") {
+      return "❌ Unable to determine current version. Package.json not found.";
+    }
+
+    // Fetch latest release from GitHub
+    const latestRelease = await getLatestRelease();
+
+    if (!latestRelease) {
+      return `ℹ️  Unable to check for updates (GitHub API unavailable).\n\nCurrent version: ${currentVersion}\n\nManually check: https://github.com/docdyhr/mcp-wordpress/releases`;
+    }
+
+    const latestVersion = latestRelease.tag_name.replace(/^v/, "");
+    const comparison = compareVersions(currentVersion, latestVersion);
+
+    if (comparison === 0) {
+      return `✅ **You're up to date!**\n\nCurrent version: v${currentVersion}\nLatest version: v${latestVersion}\n\nNo update needed.`;
+    }
+
+    if (comparison > 0) {
+      return `🔬 **You're running a pre-release version**\n\nCurrent version: v${currentVersion}\nLatest stable: v${latestVersion}\n\nYou're ahead of the latest stable release.`;
+    }
+
+    // Update available
+    const dxtUrl = `https://github.com/docdyhr/mcp-wordpress/releases/download/v${latestVersion}/mcp-wordpress.dxt`;
+
+    let releaseNotes = "";
+    if (latestRelease.body) {
+      // Extract first 500 characters of release notes
+      const notes = latestRelease.body.substring(0, 500);
+      releaseNotes = `\n\n**What's New:**\n${notes}${latestRelease.body.length > 500 ? "..." : ""}`;
+    }
+
+    return `🎉 **Update Available!**
+
+**Current version:** v${currentVersion}
+**Latest version:** v${latestVersion}
+**Released:** ${new Date(latestRelease.published_at).toLocaleDateString()}
+
+**Download Links:**
+- DXT Package: ${dxtUrl}
+- Release Page: ${latestRelease.html_url}
+
+**Update Instructions:**
+1. Backup your configuration (if using multi-site)
+2. Uninstall current version from Claude Desktop
+3. Download the new DXT package
+4. Install in Claude Desktop → Extensions
+5. Restore your configuration
+
+**Documentation:** https://github.com/docdyhr/mcp-wordpress/blob/main/docs/DXT_UPDATE_GUIDE.md${releaseNotes}`;
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return `❌ Invalid arguments: ${error.issues.map((e) => e.message).join(", ")}`;
+    }
+    return `❌ Error checking version: ${error instanceof Error ? error.message : "Unknown error"}`;
+  }
+}