MCP WordPress Server

Instructions

Implementation Reference

• src/tools/users.ts:249-313 (handler)

  The handler function that executes the wp_get_current_user tool logic. It fetches the current user from the WordPressClient, extracts and formats key details like roles, capabilities, registration date, and returns a formatted string with user profile information.
  public async handleGetCurrentUser( client: WordPressClient, params: Record<string, unknown>, ): Promise<Record<string, unknown>> { try { const user = await client.getCurrentUser(); const siteUrl = client.getSiteUrl(); // Extract meaningful information from capabilities const capabilities = user.capabilities || {}; const keyCapabilities = [ "edit_posts", "edit_pages", "publish_posts", "publish_pages", "delete_posts", "delete_pages", "manage_categories", "manage_options", "moderate_comments", "upload_files", "edit_others_posts", "delete_others_posts", ]; const userCapabilities = keyCapabilities.filter((cap) => capabilities[cap]).join(", "); const totalCapabilities = Object.keys(capabilities).length; // Format registration date more clearly const registrationDate = user.registered_date ? new Date(user.registered_date).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric", }) : "Not available"; // Extract role information const roles = user.roles || []; const primaryRole = roles[0] || "No role assigned"; const allRoles = roles.length > 1 ? roles.join(", ") : primaryRole; // Build comprehensive user information const content = `**Current User Details for ${siteUrl}**\n\n` + `- **ID:** ${user.id}\n` + `- **Display Name:** ${user.name || "Not set"}\n` + `- **Username:** ${user.slug || "Not set"}\n` + `- **Email:** ${user.email || "Not set"}\n` + `- **User URL:** ${user.url || "Not set"}\n` + `- **Nickname:** ${user.nickname || user.name || "Not set"}\n` + `- **Description:** ${user.description || "No description provided"}\n` + `- **Locale:** ${user.locale || "Default"}\n` + `- **Registration Date:** ${registrationDate}\n` + `- **Primary Role:** ${primaryRole}\n` + `- **All Roles:** ${allRoles}\n` + `- **Total Capabilities:** ${totalCapabilities} capabilities\n` + `- **Key Capabilities:** ${userCapabilities || "None"}\n` + `- **Profile Link:** ${user.link || `${siteUrl}/wp-admin/profile.php`}`; return { content }; } catch (_error) { throw new Error(`Failed to get current user: ${getErrorMessage(_error)}`); } }
• src/tools/users.ts:67-78 (registration)

  The registration of the wp_get_current_user tool within the UserTools class's getTools() method, defining its name, description, empty parameters, and binding to the handleGetCurrentUser handler.
  { name: "wp_get_current_user", description: "Retrieves the currently authenticated user with comprehensive profile information including roles, capabilities, and account details.\n\n" + "**Usage Examples:**\n" + "• Get current user: `wp_get_current_user`\n" + "• 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: [], handler: this.handleGetCurrentUser.bind(this), },