// src/tools/userTools.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
// TODO: Add these imports as you implement the functions in wordpress/api.js
import {
listUsers,
createUser,
updateUser,
disableUser,
resetUserPassword,
setUserRole,
listUserRoles
} from "../wordpress/api.js";
import {
WPUser,
WPRole,
} from '../types/interfaces.js';
/**
* Register all user and role management tools with the MCP server
*/
export function registerUserTools(server: McpServer) {
// List Users Tool
server.tool(
"list-users",
"List WordPress users with filtering options",
{
page: z.number().default(1).describe("Page number (default: 1)"),
perPage: z.number().max(100).default(10).describe("Users per page (max: 100)"),
role: z.string().optional().describe("Filter by user role (e.g., 'administrator', 'editor', 'author')"),
search: z.string().optional().describe("Search users by name or email"),
orderBy: z.enum(["id", "include", "name", "registered_date", "slug", "include_slugs", "email", "url"]).default("registered_date").describe("Order users by"),
order: z.enum(["asc", "desc"]).default("desc").describe("Sort order"),
registeredAfter: z.string().optional().describe("Filter users registered after this date (ISO format)"),
registeredBefore: z.string().optional().describe("Filter users registered before this date (ISO format)")
},
async ({ page, perPage, role, search, orderBy, order, registeredAfter, registeredBefore }) => {
try {
// TODO: Implement listUsers in wordpress/api.js
// const result = await listUsers({ page, perPage, role, search, orderBy, order, registeredAfter, registeredBefore });
return {
content: [{
type: "text",
text: "⚠️ list-users tool not yet implemented. Please add listUsers function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error listing users:", error);
return {
content: [{
type: "text",
text: `Error listing users: ${errorMessage}`
}],
isError: true
};
}
}
);
// Create User Tool
server.tool(
"create-user",
"Create a new WordPress user account",
{
username: z.string().min(1).describe("Username for the new user"),
email: z.string().email().describe("Email address for the new user"),
password: z.string().min(6).describe("Password for the new user (min 6 characters)"),
firstName: z.string().optional().describe("User's first name"),
lastName: z.string().optional().describe("User's last name"),
displayName: z.string().optional().describe("Display name (defaults to username)"),
role: z.string().default("subscriber").describe("User role (default: subscriber)"),
bio: z.string().optional().describe("User biography/description"),
website: z.string().url().optional().describe("User's website URL"),
sendNotification: z.boolean().default(true).describe("Send welcome email to new user")
},
async ({ username, email, password, firstName, lastName, displayName, role, bio, website, sendNotification }) => {
try {
// TODO: Implement createUser in wordpress/api.js
const result = await createUser({
username,
email,
password,
firstName,
lastName,
displayName: displayName || username,
role,
bio,
website,
sendNotification
});
return {
content: [{
type: "text",
text: "⚠️ create-user tool not yet implemented. Please add createUser function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error creating user:", error);
return {
content: [{
type: "text",
text: `Error creating user: ${errorMessage}`
}],
isError: true
};
}
}
);
// Update User Tool
server.tool(
"update-user",
"Update an existing WordPress user's profile details",
{
userId: z.number().describe("ID of the user to update"),
email: z.string().email().optional().describe("New email address"),
firstName: z.string().optional().describe("New first name"),
lastName: z.string().optional().describe("New last name"),
displayName: z.string().optional().describe("New display name"),
bio: z.string().optional().describe("New biography/description"),
website: z.string().url().optional().describe("New website URL"),
password: z.string().min(6).optional().describe("New password (min 6 characters)")
},
async ({ userId, email, firstName, lastName, displayName, bio, website, password }) => {
try {
// TODO: Implement updateUser in wordpress/api.js
const result = await updateUser(userId, {
email,
firstName,
lastName,
displayName,
bio,
website,
password
});
return {
content: [{
type: "text",
text: "⚠️ update-user tool not yet implemented. Please add updateUser function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error updating user:", error);
return {
content: [{
type: "text",
text: `Error updating user: ${errorMessage}`
}],
isError: true
};
}
}
);
// Disable User Tool
server.tool(
"disable-user",
"Temporarily deactivate a WordPress user account",
{
userId: z.number().describe("ID of the user to disable"),
reason: z.string().optional().describe("Reason for disabling the account")
},
async ({ userId, reason }) => {
try {
// TODO: Implement disableUser in wordpress/api.js
const result = await disableUser(userId, reason);
return {
content: [{
type: "text",
text: "⚠️ disable-user tool not yet implemented. Please add disableUser function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error disabling user:", error);
return {
content: [{
type: "text",
text: `Error disabling user: ${errorMessage}`
}],
isError: true
};
}
}
);
// Reset User Password Tool
server.tool(
"reset-user-password",
"Generate a password reset link for a WordPress user",
{
userId: z.number().optional().describe("ID of the user (optional if email provided)"),
email: z.string().email().optional().describe("Email of the user (optional if userId provided)"),
sendEmail: z.boolean().default(true).describe("Send reset link via email")
},
async ({ userId, email, sendEmail }) => {
try {
if (!userId && !email) {
return {
content: [{
type: "text",
text: "Either userId or email must be provided"
}],
isError: true
};
}
// TODO: Implement resetUserPassword in wordpress/api.js
const result = await resetUserPassword({ userId, email, sendEmail });
return {
content: [{
type: "text",
text: "⚠️ reset-user-password tool not yet implemented. Please add resetUserPassword function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error resetting user password:", error);
return {
content: [{
type: "text",
text: `Error resetting user password: ${errorMessage}`
}],
isError: true
};
}
}
);
// Set User Role Tool
server.tool(
"set-user-role",
"Change a WordPress user's role and permissions",
{
userId: z.number().describe("ID of the user"),
role: z.string().describe("New role to assign (e.g., 'administrator', 'editor', 'author', 'contributor', 'subscriber')"),
removeOtherRoles: z.boolean().default(true).describe("Remove other roles when setting new role")
},
async ({ userId, role, removeOtherRoles }) => {
try {
// Validate common WordPress roles
const validRoles = ['administrator', 'editor', 'author', 'contributor', 'subscriber'];
if (!validRoles.includes(role.toLowerCase())) {
console.warn(`Warning: '${role}' is not a standard WordPress role. Proceeding anyway...`);
}
// TODO: Implement setUserRole in wordpress/api.js
const result = await setUserRole(userId, role, removeOtherRoles);
return {
content: [{
type: "text",
text: "⚠️ set-user-role tool not yet implemented. Please add setUserRole function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error setting user role:", error);
return {
content: [{
type: "text",
text: `Error setting user role: ${errorMessage}`
}],
isError: true
};
}
}
);
// List User Roles Tool
server.tool(
"list-user-roles",
"View available WordPress user roles and their capabilities",
{
includeCapabilities: z.boolean().default(false).describe("Include detailed capability information for each role")
},
async ({ includeCapabilities }) => {
try {
// TODO: Implement listUserRoles in wordpress/api.js
const result = await listUserRoles(includeCapabilities);
return {
content: [{
type: "text",
text: "⚠️ list-user-roles tool not yet implemented. Please add listUserRoles function to wordpress/api.js"
}],
isError: true
};
} catch (error: unknown) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error';
console.error("Error listing user roles:", error);
return {
content: [{
type: "text",
text: `Error listing user roles: ${errorMessage}`
}],
isError: true
};
}
}
);
}
