mcp-wordpress 3.1.11 → 3.1.13

package/src/tools/taxonomies.ts

@@ -1,4 +1,5 @@
 import { WordPressClient } from "@/client/api.js";
+import type { MCPToolSchema } from "@/types/mcp.js";
 import { CreateCategoryRequest, CreateTagRequest, UpdateCategoryRequest, UpdateTagRequest } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
 import { toolParams } from "./params.js";
@@ -15,14 +16,7 @@ export class TaxonomyTools {
   public getTools(): Array<{
     name: string;
     description: string;
-    parameters?: Array<{
-      name: string;
-      type?: string;
-      description?: string;
-      required?: boolean;
-      enum?: string[];
-      items?: unknown;
-    }>;
+    inputSchema?: MCPToolSchema;
     handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
   }> {
     return [
@@ -30,150 +24,166 @@ export class TaxonomyTools {
       {
         name: "wp_list_categories",
         description: "Lists categories from a WordPress site.",
-        parameters: [
-          {
-            name: "search",
-            type: "string",
-            description: "Limit results to those matching a search term.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            search: {
+              type: "string",
+              description: "Limit results to those matching a search term.",
+            },
+            hide_empty: {
+              type: "boolean",
+              description: "Whether to hide categories with no posts.",
+            },
           },
-          {
-            name: "hide_empty",
-            type: "boolean",
-            description: "Whether to hide categories with no posts.",
-          },
-        ],
+        },
         handler: this.handleListCategories.bind(this),
       },
       {
         name: "wp_get_category",
         description: "Retrieves a single category by its ID.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The unique identifier for the category.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The unique identifier for the category.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleGetCategory.bind(this),
       },
       {
         name: "wp_create_category",
         description: "Creates a new category.",
-        parameters: [
-          {
-            name: "name",
-            type: "string",
-            required: true,
-            description: "The name of the category.",
-          },
-          {
-            name: "description",
-            type: "string",
-            description: "The description for the category.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "The name of the category.",
+            },
+            description: {
+              type: "string",
+              description: "The description for the category.",
+            },
           },
-        ],
+          required: ["name"],
+        },
         handler: this.handleCreateCategory.bind(this),
       },
       {
         name: "wp_update_category",
         description: "Updates an existing category.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the category to update.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the category to update.",
+            },
+            name: {
+              type: "string",
+              description: "The new name for the category.",
+            },
           },
-          {
-            name: "name",
-            type: "string",
-            description: "The new name for the category.",
-          },
-        ],
+          required: ["id"],
+        },
         handler: this.handleUpdateCategory.bind(this),
       },
       {
         name: "wp_delete_category",
         description: "Deletes a category.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the category to delete.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the category to delete.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleDeleteCategory.bind(this),
       },
       // Tags
       {
         name: "wp_list_tags",
         description: "Lists tags from a WordPress site.",
-        parameters: [
-          {
-            name: "search",
-            type: "string",
-            description: "Limit results to those matching a search term.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            search: {
+              type: "string",
+              description: "Limit results to those matching a search term.",
+            },
           },
-        ],
+        },
         handler: this.handleListTags.bind(this),
       },
       {
         name: "wp_get_tag",
         description: "Retrieves a single tag by its ID.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The unique identifier for the tag.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The unique identifier for the tag.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleGetTag.bind(this),
       },
       {
         name: "wp_create_tag",
         description: "Creates a new tag.",
-        parameters: [
-          {
-            name: "name",
-            type: "string",
-            required: true,
-            description: "The name of the tag.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "The name of the tag.",
+            },
           },
-        ],
+          required: ["name"],
+        },
         handler: this.handleCreateTag.bind(this),
       },
       {
         name: "wp_update_tag",
         description: "Updates an existing tag.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the tag to update.",
-          },
-          {
-            name: "name",
-            type: "string",
-            description: "The new name for the tag.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the tag to update.",
+            },
+            name: {
+              type: "string",
+              description: "The new name for the tag.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleUpdateTag.bind(this),
       },
       {
         name: "wp_delete_tag",
         description: "Deletes a tag.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the tag to delete.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the tag to delete.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleDeleteTag.bind(this),
       },
     ];

package/src/tools/users.ts

@@ -1,4 +1,5 @@
 import { WordPressClient } from "@/client/api.js";
+import type { MCPToolSchema } from "@/types/mcp.js";
 import { CreateUserRequest, UpdateUserRequest, UserQueryParams } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
 import { WordPressDataStreamer, StreamingUtils, StreamingResult } from "@/utils/streaming.js";
@@ -16,14 +17,7 @@ export class UserTools {
   public getTools(): Array<{
     name: string;
     description: string;
-    parameters?: Array<{
-      name: string;
-      type?: string;
-      description?: string;
-      required?: boolean;
-      enum?: string[];
-      items?: unknown;
-    }>;
+    inputSchema?: MCPToolSchema;
     handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
   }> {
     return [
@@ -31,38 +25,43 @@ export class UserTools {
         name: "wp_list_users",
         description:
           "Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status.\n\n" +
+          "**Note:** Role, email, and registration date fields require **administrator** privileges. " +
+          "Non-admin users will see limited metadata due to WordPress REST API restrictions.\n\n" +
           "**Usage Examples:**\n" +
           "• List all users: `wp_list_users`\n" +
           '• Search users: `wp_list_users --search="john"`\n' +
           '• Filter by role: `wp_list_users --roles=["editor","author"]`\n' +
           '• Find admins: `wp_list_users --roles=["administrator"]`\n' +
           '• Combined search: `wp_list_users --search="smith" --roles=["subscriber"]`',
-        parameters: [
-          {
-            name: "search",
-            type: "string",
-            description: "Limit results to those matching a search term.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            search: {
+              type: "string",
+              description: "Limit results to those matching a search term.",
+            },
+            roles: {
+              type: "array",
+              items: { type: "string" },
+              description: "Limit results to users with specific roles.",
+            },
           },
-          {
-            name: "roles",
-            type: "array",
-            items: { type: "string" },
-            description: "Limit results to users with specific roles.",
-          },
-        ],
+        },
         handler: this.handleListUsers.bind(this),
       },
       {
         name: "wp_get_user",
         description: "Retrieves a single user by their ID.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The unique identifier for the user.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The unique identifier for the user.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleGetUser.bind(this),
       },
       {
@@ -74,79 +73,80 @@ export class UserTools {
           "• Check permissions: Use this to verify your current user's capabilities and roles\n" +
           "• Account verification: Confirm you're authenticated with the correct account\n" +
           "• Profile details: View registration date, email, and user metadata",
-        parameters: [],
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
         handler: this.handleGetCurrentUser.bind(this),
       },
       {
         name: "wp_create_user",
         description: "Creates a new user.",
-        parameters: [
-          {
-            name: "username",
-            type: "string",
-            required: true,
-            description: "The username for the new user.",
-          },
-          {
-            name: "email",
-            type: "string",
-            required: true,
-            description: "The email address for the new user.",
-          },
-          {
-            name: "password",
-            type: "string",
-            required: true,
-            description: "The password for the new user.",
-          },
-          {
-            name: "roles",
-            type: "array",
-            items: { type: "string" },
-            description: "An array of roles to assign to the user.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            username: {
+              type: "string",
+              description: "The username for the new user.",
+            },
+            email: {
+              type: "string",
+              description: "The email address for the new user.",
+            },
+            password: {
+              type: "string",
+              description: "The password for the new user.",
+            },
+            roles: {
+              type: "array",
+              items: { type: "string" },
+              description: "An array of roles to assign to the user.",
+            },
           },
-        ],
+          required: ["username", "email", "password"],
+        },
         handler: this.handleCreateUser.bind(this),
       },
       {
         name: "wp_update_user",
         description: "Updates an existing user.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the user to update.",
-          },
-          {
-            name: "email",
-            type: "string",
-            description: "The new email address for the user.",
-          },
-          {
-            name: "name",
-            type: "string",
-            description: "The new display name for the user.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the user to update.",
+            },
+            email: {
+              type: "string",
+              description: "The new email address for the user.",
+            },
+            name: {
+              type: "string",
+              description: "The new display name for the user.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleUpdateUser.bind(this),
       },
       {
         name: "wp_delete_user",
         description: "Deletes a user.",
-        parameters: [
-          {
-            name: "id",
-            type: "number",
-            required: true,
-            description: "The ID of the user to delete.",
-          },
-          {
-            name: "reassign",
-            type: "number",
-            description: "The ID of a user to reassign the deleted user's content to.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "number",
+              description: "The ID of the user to delete.",
+            },
+            reassign: {
+              type: "number",
+              description: "The ID of a user to reassign the deleted user's content to.",
+            },
           },
-        ],
+          required: ["id"],
+        },
         handler: this.handleDeleteUser.bind(this),
       },
     ];
@@ -208,16 +208,16 @@ export class UserTools {
                   month: "short",
                   day: "numeric",
                 })
-              : "Unknown";
+              : "Restricted (requires admin)";
 
-            const roles = u.roles?.join(", ") || "No roles";
+            const roles = u.roles?.length ? u.roles.join(", ") : "Restricted (requires admin)";
             const description = u.description || "No description";
             const displayName = u.name || "No display name";
             const userUrl = u.url || "No URL";
 
             return (
               `- **ID ${u.id}**: ${displayName} (@${u.slug})\n` +
-              `  📧 Email: ${u.email || "No email"}\n` +
+              `  📧 Email: ${u.email || "Restricted (requires admin)"}\n` +
               `  🎭 Roles: ${roles}\n` +
               `  📅 Registered: ${registrationDate}\n` +
               `  🔗 URL: ${userUrl}\n` +