Skip to main content

Users

MCP tools for the Users module. See the Users module docs for permissions and data model.

get-current-user​

Get the current authenticated user

Arguments​

This tool takes no arguments.

list-users​

List all users

Arguments​

ArgumentTypeRequiredDescription
limitnumbernoResults per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED.
cursorstringnoThe previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR.

create-user​

Create a user

Arguments​

ArgumentTypeRequiredDescription
usernamestringyes—
passwordstringyes—
rolestringno—

get-user​

Get a user by ID

Arguments​

ArgumentTypeRequiredDescription
user_idstringyesUser ID

delete-user​

Delete a user by ID

Arguments​

ArgumentTypeRequiredDescription
user_idstringyesUser ID

bootstrap-user​

Create the first admin user

Arguments​

ArgumentTypeRequiredDescription
usernamestringyes—
passwordstringyes—

login-user​

Login user

Arguments​

ArgumentTypeRequiredDescription
usernamestringyes—
passwordstringyes—

attach-user-policies​

Attach policies to a user

Arguments​

ArgumentTypeRequiredDescription
user_idstringyesUser public ID (user_ prefix)
policy_idsarray<string>yesList of policy public IDs to attach (replaces existing)