mcp_list_users
List WordPress users with role and search filters, returning IDs, usernames, emails, roles, and registration dates with pagination for browsing site accounts.
Instructions
List WordPress users (id, username, email, display_name, first_name, last_name, roles, registered) with role/search filters. Returns { users, total, page }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site": "<site>"
},
"name": "mcp_list_users"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1) | |
| role | No | Filter by role slug (administrator, editor, author, contributor, subscriber, or a custom role) | |
| site | Yes | Site id (see list_sites) | |
| order | No | Sort direction (default DESC) | |
| search | No | Search login, email, URL, nicename or display name (wildcard on both sides) | |
| orderby | No | Order by field (default registered) | |
| per_page | No | Users per page (default 20) |