> For the complete documentation index, see [llms.txt](https://docs.hostinger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostinger.com/wordpress/hostinger-plugins/ai-plugin/abilities/users.md).

# Users

Users abilities of the Hostinger AI plugin's WordPress site MCP server. Search, create, update and delete user accounts, including the connected user.

Search, create, update and delete user accounts, including the connected user.

**Available:** Always.

| Ability                                     | What it does                                                                                             | Type                             |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [Create User](#create-user)                 | Create a user account from a username, email and password.                                               | Changes the site                 |
| [Get Current User](#get-current-user)       | Get the account you are acting as.                                                                       | Read-only                        |
| [Update Current User](#update-current-user) | Update the profile of the account you are acting as; only the fields you pass change.                    | Changes the site · Safe to retry |
| [Delete User](#delete-user)                 | Permanently delete a user account; their posts and links are reassigned to the user given in `reassign`. | **Destructive** · Safe to retry  |
| [Get User](#get-user)                       | Get one user by ID with all their fields.                                                                | Read-only                        |
| [Search Users](#search-users)               | Search and filter users with pagination.                                                                 | Read-only                        |
| [Update User](#update-user)                 | Update a user account; only the fields you pass change.                                                  | Changes the site · Safe to retry |

## Create User

`hostinger-ai/users-create` · Changes the site

Create a user account from a username, email and password.

| Required parameter | Type   | Description                             |
| ------------------ | ------ | --------------------------------------- |
| `username`         | string | Login name for the user.                |
| `email`            | string | The email address for the user.         |
| `password`         | string | Password for the user (never included). |

<details>

<summary>Optional parameters (9)</summary>

| Parameter     | Type                 | Description                              |
| ------------- | -------------------- | ---------------------------------------- |
| `name`        | string               | Display name for the user.               |
| `first_name`  | string               | First name for the user.                 |
| `last_name`   | string               | Last name for the user.                  |
| `url`         | string               | URL of the user.                         |
| `description` | string               | Description of the user.                 |
| `locale`      | one of \`\`, `en_US` | Locale for the user.                     |
| `nickname`    | string               | The nickname for the user.               |
| `slug`        | string               | An alphanumeric identifier for the user. |
| `roles`       | array of string      | Roles assigned to the user.              |

</details>

<details>

<summary>Description sent to AI tools</summary>

> Create a user account from a username, email and password. Use when asked to add a new user or administrator to the site.

</details>

## Get Current User

`hostinger-ai/users-current-get` · Read-only

Get the account you are acting as.

No parameters.

<details>

<summary>Description sent to AI tools</summary>

> Get the account you are acting as. Use when you need your own user ID or profile, for example to set yourself as a post author.

</details>

## Update Current User

`hostinger-ai/users-current-update` · Changes the site · Safe to retry

Update the profile of the account you are acting as; only the fields you pass change.

No required parameters.

<details>

<summary>Optional parameters (12)</summary>

| Parameter     | Type                 | Description                              |
| ------------- | -------------------- | ---------------------------------------- |
| `username`    | string               | Login name for the user.                 |
| `name`        | string               | Display name for the user.               |
| `first_name`  | string               | First name for the user.                 |
| `last_name`   | string               | Last name for the user.                  |
| `email`       | string               | The email address for the user.          |
| `url`         | string               | URL of the user.                         |
| `description` | string               | Description of the user.                 |
| `locale`      | one of \`\`, `en_US` | Locale for the user.                     |
| `nickname`    | string               | The nickname for the user.               |
| `slug`        | string               | An alphanumeric identifier for the user. |
| `roles`       | array of string      | Roles assigned to the user.              |
| `password`    | string               | Password for the user (never included).  |

</details>

<details>

<summary>Description sent to AI tools</summary>

> Update the profile of the account you are acting as; only the fields you pass change. Use when asked to change your own name, email or password.

</details>

## Delete User

`hostinger-ai/users-delete` · **Destructive** · Safe to retry

Permanently delete a user account; their posts and links are reassigned to the user given in `reassign`.

| Required parameter | Type    | Description                                                     |
| ------------------ | ------- | --------------------------------------------------------------- |
| `id`               | integer | Unique identifier for the resource                              |
| `reassign`         | integer | ID of the user who receives the deleted user's posts and links. |

<details>

<summary>Description sent to AI tools</summary>

> Permanently delete a user account; their posts and links are reassigned to the user given in `reassign`. This cannot be undone. Use when asked to remove a user. Needs `id` and `reassign` from `hostinger-ai/users-search`.

</details>

## Get User

`hostinger-ai/users-get` · Read-only

Get one user by ID with all their fields.

| Required parameter | Type    | Description                        |
| ------------------ | ------- | ---------------------------------- |
| `id`               | integer | Unique identifier for the resource |

<details>

<summary>Description sent to AI tools</summary>

> Get one user by ID with all their fields. Use when you need the details of a known account. Needs `id` from `hostinger-ai/users-search`.

</details>

## Search Users

`hostinger-ai/users-search` · Read-only

Search and filter users with pagination.

No required parameters.

<details>

<summary>Optional parameters (12)</summary>

| Parameter             | Type                                                                                       | Default | Description                                                                                                          |
| --------------------- | ------------------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------- |
| `page`                | integer                                                                                    | `1`     | Current page of the collection.                                                                                      |
| `per_page`            | integer                                                                                    | `10`    | Maximum number of items to be returned in result set.                                                                |
| `search`              | string                                                                                     |         | Limit results to those matching a string.                                                                            |
| `exclude`             | array of integer                                                                           | `[]`    | Ensure result set excludes specific IDs.                                                                             |
| `include`             | array of integer                                                                           | `[]`    | Limit result set to specific IDs.                                                                                    |
| `order`               | one of `asc`, `desc`                                                                       | `asc`   | Order sort attribute ascending or descending.                                                                        |
| `orderby`             | one of `id`, `include`, `name`, `registered_date`, `slug`, `include_slugs`, `email`, `url` | `name`  | Sort collection by user attribute.                                                                                   |
| `slug`                | array of string                                                                            |         | Limit result set to users with one or more specific slugs.                                                           |
| `roles`               | array of string                                                                            |         | Limit result set to users matching at least one specific role provided. Accepts csv list or single role.             |
| `capabilities`        | array of string                                                                            |         | Limit result set to users matching at least one specific capability provided. Accepts csv list or single capability. |
| `who`                 | one of `authors`                                                                           |         | Limit result set to users who are considered authors.                                                                |
| `has_published_posts` | array of `post`, `page`                                                                    |         | Limit result set to users who have published posts.                                                                  |

</details>

<details>

<summary>Description sent to AI tools</summary>

> Search and filter users with pagination. Use when you need a user ID, for example for a post author, or to find an account.

</details>

## Update User

`hostinger-ai/users-update` · Changes the site · Safe to retry

Update a user account; only the fields you pass change.

| Required parameter | Type    | Description                        |
| ------------------ | ------- | ---------------------------------- |
| `id`               | integer | Unique identifier for the resource |

<details>

<summary>Optional parameters (12)</summary>

| Parameter     | Type                 | Description                              |
| ------------- | -------------------- | ---------------------------------------- |
| `username`    | string               | Login name for the user.                 |
| `name`        | string               | Display name for the user.               |
| `first_name`  | string               | First name for the user.                 |
| `last_name`   | string               | Last name for the user.                  |
| `email`       | string               | The email address for the user.          |
| `url`         | string               | URL of the user.                         |
| `description` | string               | Description of the user.                 |
| `locale`      | one of \`\`, `en_US` | Locale for the user.                     |
| `nickname`    | string               | The nickname for the user.               |
| `slug`        | string               | An alphanumeric identifier for the user. |
| `roles`       | array of string      | Roles assigned to the user.              |
| `password`    | string               | Password for the user (never included).  |

</details>

<details>

<summary>Description sent to AI tools</summary>

> Update a user account; only the fields you pass change. Use when asked to change a user role, name, email or password. Needs `id` from `hostinger-ai/users-search`.

</details>

## Related

* [Abilities Reference](https://docs.hostinger.com/wordpress/hostinger-plugins/ai-plugin/abilities.md)
* [WordPress Site MCP Server](https://docs.hostinger.com/wordpress/hostinger-plugins/ai-plugin/mcp-server.md)
