Skip to content

User Management

AutoWP MCP provides tools for managing WordPress users and their roles directly from your LLM client. These tools allow you to list, create, update, disable, and reset users, as well as manage user roles and permissions.

Core User Operations

list-users

List WordPress users with optional filters such as role, search keyword, or registration date.

Parameters:

  • role (string, optional): Filter users by role (e.g., "editor").
  • search (string, optional): Search users by name or email.
  • registered_after (string, optional): Only users registered after this date (ISO 8601).

Example:

json
{
  "tool": "list-users",
  "params": {
    "role": "author",
    "search": "jane"
  }
}

create-user

Create a new user with optional profile and role details.

Parameters:

  • username (string, required): Username for the new user.
  • email (string, required): Email address.
  • password (string, required): Password.
  • role (string, optional): User role (e.g., "contributor").
  • name (string, optional): Display name.
  • bio (string, optional): User bio.

Example:

json
{
  "tool": "create-user",
  "params": {
    "username": "janedoe",
    "email": "jane@example.com",
    "password": "securepassword",
    "role": "editor",
    "name": "Jane Doe"
  }
}

update-user

Update user profile data including email, name, bio, and password.

Parameters:

  • id (integer, required): User ID.
  • email, name, bio, password (optional): Fields to update.

Example:

json
{
  "tool": "update-user",
  "params": {
    "id": 12,
    "email": "newemail@example.com",
    "name": "Jane D.",
    "bio": "Updated bio"
  }
}

disable-user

Temporarily deactivate a user account with an optional reason.

Parameters:

  • id (integer, required): User ID.
  • reason (string, optional): Reason for disabling.

Example:

json
{
  "tool": "disable-user",
  "params": {
    "id": 12,
    "reason": "Suspicious activity"
  }
}

reset-user-password

Generate a password reset link or email it to the user.

Parameters:

  • id (integer, required): User ID.

Example:

json
{
  "tool": "reset-user-password",
  "params": {
    "id": 12
  }
}

Role & Permission Management

set-user-role

Assign a specific role to a user, optionally removing other roles.

Parameters:

  • id (integer, required): User ID.
  • role (string, required): Role to assign.

Example:

json
{
  "tool": "set-user-role",
  "params": {
    "id": 12,
    "role": "author"
  }
}

list-user-roles

View all available WordPress user roles and their capabilities.

Example:

json
{
  "tool": "list-user-roles"
}

For plugin and theme management, see Plugin & Theme Settings.