MCP tool · Applications
manage_wp_users
List the users of one WordPress site, create a user, or change a user's role over WP-CLI.
manage_wp_users
Description
List the users of one WordPress site, create a user, or change a user's role over WP-CLI. action=list (needs only read:hosting) returns users[] {id, login, displayName, email, roles}. create needs login, email and role (optional display_name); the password is generated on the server and returned once in user.password — hand it to the customer, never store or repeat it, and created:false with message means nothing was made. set_role needs id (from list → users[].id, never guessed) and role.
Input
| Name | Type | Description |
|---|---|---|
input
required
|
string |
A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved target is echoed back in the response.
|
action
required
|
enum |
list the users, create one (password generated and returned once), or set_role on one. create/set_role require write:hosting. One of list, create, set_role.
|
id
|
integer |
The user id for set_role. From list → users[].id; never guessed.
|
login
|
string |
For create: the username (letters, digits, space, ., _, @, -; max 60).
|
email
|
string |
For create: the user's email address.
|
role
|
enum |
The WordPress role for create and set_role. One of administrator, editor, author, contributor, subscriber.
|
display_name
|
string |
For create: the name shown on the site (max 80). Defaults to the login.
|
path
|
string |
Optional subfolder of a WordPress install not at the domain root (e.g. blog).
|