> 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/comments.md).

# Comments

Comments abilities of the Hostinger AI plugin's WordPress site MCP server. Search, read and reply to comments, and approve, unapprove or mark them as spam.

Search, read and reply to comments, and approve, unapprove or mark them as spam.

**Available:** Always.

| Ability                                           | What it does                                                                                   | Type                             |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------- |
| [Approve Comment](#approve-comment)               | Approve a comment, making it publicly visible.                                                 | Changes the site · Safe to retry |
| [Create Comment](#create-comment)                 | Create a comment on a post from its content.                                                   | Changes the site                 |
| [Delete Comment](#delete-comment)                 | Delete a comment; it is moved to the trash unless force is true, which deletes it permanently. | **Destructive** · Safe to retry  |
| [Get Comment](#get-comment)                       | Get one comment by ID with all its fields.                                                     | Read-only                        |
| [Search Comments](#search-comments)               | Search and filter comments with pagination, including WooCommerce product reviews.             | Read-only                        |
| [Mark Comment As Spam](#mark-comment-as-spam)     | Mark a comment as spam.                                                                        | Changes the site · Safe to retry |
| [Unapprove Comment](#unapprove-comment)           | Unapprove a comment, moving it back to pending moderation.                                     | Changes the site · Safe to retry |
| [Unmark Comment As Spam](#unmark-comment-as-spam) | Restore a comment that was marked as spam to its previous moderation status.                   | Changes the site · Safe to retry |
| [Update Comment](#update-comment)                 | Update a comment; only the fields you pass change.                                             | Changes the site · Safe to retry |

## Approve Comment

`hostinger-ai/comments-approve` · Changes the site · Safe to retry

Approve a comment, making it publicly visible.

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

<details>

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

> Approve a comment, making it publicly visible. Use when asked to publish a pending comment. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Create Comment

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

Create a comment on a post from its content.

| Required parameter | Type    | Default | Description                            |
| ------------------ | ------- | ------- | -------------------------------------- |
| `post`             | integer | `0`     | ID of the post the comment belongs to. |
| `content`          | string  |         | Content of the comment.                |

<details>

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

| Parameter           | Type    | Default | Description                                      |
| ------------------- | ------- | ------- | ------------------------------------------------ |
| `author`            | integer |         | The ID of the user object, if author was a user. |
| `author_email`      | string  |         | Email address for the comment author.            |
| `author_ip`         | string  |         | IP address for the comment author.               |
| `author_name`       | string  |         | Display name for the comment author.             |
| `author_url`        | string  |         | URL for the comment author.                      |
| `author_user_agent` | string  |         | User agent for the comment author.               |
| `parent`            | integer | `0`     | The ID for the parent of the comment.            |
| `status`            | string  |         | State of the comment.                            |

</details>

<details>

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

> Create a comment on a post from its content. Use when asked to add or reply to a comment. Needs `post` from `hostinger-ai/posts-search`, and a `parent` comment ID from `hostinger-ai/comments-search` when replying.

</details>

## Delete Comment

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

Delete a comment; it is moved to the trash unless force is true, which deletes it permanently.

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

<details>

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

| Parameter | Type    | Description                                        |
| --------- | ------- | -------------------------------------------------- |
| `force`   | boolean | Skip the trash and delete the comment permanently. |

</details>

<details>

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

> Delete a comment; it is moved to the trash unless force is true, which deletes it permanently. Use when asked to remove a comment. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Get Comment

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

Get one comment by ID with all its fields.

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

<details>

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

> Get one comment by ID with all its fields. Use when you need the details of a known comment. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Search Comments

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

Search and filter comments with pagination, including WooCommerce product reviews.

No required parameters.

<details>

<summary>Optional parameters (14)</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.                                                         |
| `author`       | array of integer                                                     |            | Limit result set to comments assigned to specific user IDs. Requires authorization.               |
| `author_email` | string                                                               |            | Limit result set to that from a specific author email. Requires authorization.                    |
| `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`                                                 | `desc`     | Order sort attribute ascending or descending.                                                     |
| `orderby`      | one of `date`, `date_gmt`, `id`, `include`, `post`, `parent`, `type` | `date_gmt` | Sort collection by comment attribute.                                                             |
| `parent`       | array of integer                                                     | `[]`       | Limit result set to comments of specific parent IDs.                                              |
| `post`         | array of integer                                                     | `[]`       | Limit result set to comments assigned to specific post IDs.                                       |
| `status`       | string                                                               | `approve`  | Moderation status to filter by: approve, hold (pending), spam, trash or all.                      |
| `type`         | string                                                               | `comment`  | Comment type to filter by, for example comment or review. Use an empty value to return all types. |
| `password`     | string                                                               |            | The password for the post if it is password protected.                                            |

</details>

<details>

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

> Search and filter comments with pagination, including WooCommerce product reviews. Use when you need a comment ID, or to review comments awaiting moderation.

</details>

## Mark Comment As Spam

`hostinger-ai/comments-spam` · Changes the site · Safe to retry

Mark a comment as spam.

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

<details>

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

> Mark a comment as spam. Use when asked to flag a comment as spam. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Unapprove Comment

`hostinger-ai/comments-unapprove` · Changes the site · Safe to retry

Unapprove a comment, moving it back to pending moderation.

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

<details>

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

> Unapprove a comment, moving it back to pending moderation. Use when asked to hide a published comment until it is reviewed. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Unmark Comment As Spam

`hostinger-ai/comments-unspam` · Changes the site · Safe to retry

Restore a comment that was marked as spam to its previous moderation status.

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

<details>

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

> Restore a comment that was marked as spam to its previous moderation status. Use when a comment was flagged as spam by mistake. Needs `id` from `hostinger-ai/comments-search`.

</details>

## Update Comment

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

Update a comment; only the fields you pass change.

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

<details>

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

| Parameter           | Type    | Description                                      |
| ------------------- | ------- | ------------------------------------------------ |
| `author`            | integer | The ID of the user object, if author was a user. |
| `author_email`      | string  | Email address for the comment author.            |
| `author_ip`         | string  | IP address for the comment author.               |
| `author_name`       | string  | Display name for the comment author.             |
| `author_url`        | string  | URL for the comment author.                      |
| `author_user_agent` | string  | User agent for the comment author.               |
| `content`           | string  | Content of the comment.                          |
| `parent`            | integer | The ID for the parent of the comment.            |
| `post`              | integer | The ID of the associated post object.            |
| `status`            | string  | State of the comment.                            |

</details>

<details>

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

> Update a comment; only the fields you pass change. Change the moderation state with status (approve, hold, spam, trash). Use when asked to edit or moderate a comment. Needs `id` from `hostinger-ai/comments-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)
