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

# Posts

Posts abilities of the Hostinger AI plugin's WordPress site MCP server. Search, read, create, update and delete blog posts.

Search, read, create, update and delete blog posts.

**Available:** Always.

| Ability                       | What it does                                                                                                                              | Type                             |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [Create Post](#create-post)   | Create a blog post from a title and content.                                                                                              | Changes the site                 |
| [Delete Post](#delete-post)   | Move a blog post to the trash and remove the menu links that point to it; the post can be restored from the trash, the menu links cannot. | **Destructive** · Safe to retry  |
| [Get Post](#get-post)         | Get one blog post by ID with all its fields.                                                                                              | Read-only                        |
| [Search Posts](#search-posts) | Search and filter blog posts with pagination.                                                                                             | Read-only                        |
| [Update Post](#update-post)   | Update a blog post; only the fields you pass change.                                                                                      | Changes the site · Safe to retry |

## Create Post

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

Create a blog post from a title and content.

| Required parameter | Type             | Description             |
| ------------------ | ---------------- | ----------------------- |
| `title`            | string or object | The title for the post. |

<details>

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

| Parameter        | Type                                                                                                                                                                                                             | Description                                                 |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `slug`           | string                                                                                                                                                                                                           | An alphanumeric identifier for the post unique to its type. |
| `status`         | one of `publish`, `future`, `draft`, `pending`, `private`, `in-progress`, `failed`, `wc-pending`, `wc-processing`, `wc-on-hold`, `wc-completed`, `wc-cancelled`, `wc-refunded`, `wc-failed`, `wc-checkout-draft` | A named status for the post.                                |
| `password`       | string                                                                                                                                                                                                           | A password to protect access to the content and excerpt.    |
| `content`        | string or object                                                                                                                                                                                                 | The content for the post.                                   |
| `author`         | integer                                                                                                                                                                                                          | The ID for the author of the post.                          |
| `excerpt`        | string or object                                                                                                                                                                                                 | The excerpt for the post.                                   |
| `featured_media` | integer                                                                                                                                                                                                          | The ID of the featured media for the post.                  |
| `comment_status` | one of `open`, `closed`                                                                                                                                                                                          | Whether or not comments are open on the post.               |
| `ping_status`    | one of `open`, `closed`                                                                                                                                                                                          | Whether or not the post can be pinged.                      |
| `format`         | one of `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`                                                                                                              | The format for the post.                                    |
| `sticky`         | boolean                                                                                                                                                                                                          | Whether or not the post should be treated as sticky.        |
| `template`       | string                                                                                                                                                                                                           | The theme file to use to display the post.                  |
| `categories`     | array of integer                                                                                                                                                                                                 | The terms assigned to the post in the category taxonomy.    |
| `tags`           | array of integer                                                                                                                                                                                                 | The terms assigned to the post in the post\_tag taxonomy.   |

</details>

<details>

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

> Create a blog post from a title and content. Use when asked to write or publish a new post. Send HTML or block markup; HTML is converted to blocks. Optional `categories`, `tags`, `featured_media` and `author` IDs come from `hostinger-ai/categories-search`, `hostinger-ai/tags-search`, `hostinger-ai/media-search` and `hostinger-ai/users-search`. The response includes view\_url and edit\_url; after creating it, always include a direct link to the new post in your reply (view\_url if published, otherwise edit\_url).

</details>

## Delete Post

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

Move a blog post to the trash and remove the menu links that point to it; the post can be restored from the trash, the menu links cannot.

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

<details>

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

> Move a blog post to the trash and remove the menu links that point to it; the post can be restored from the trash, the menu links cannot. Use when asked to remove a post. Needs `id` from `hostinger-ai/posts-search`.

</details>

## Get Post

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

Get one blog post 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 blog post by ID with all its fields. Use when you need the full content or settings of a known post. Needs `id` from `hostinger-ai/posts-search`.

</details>

## Search Posts

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

Search and filter blog posts with pagination.

No required parameters.

<details>

<summary>Optional parameters (15)</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 posts assigned to specific authors.                            |
| `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 `author`, `date`, `id`, `include`, `modified`, `parent`, `relevance`, `slug`, `include_slugs`, `title`                                                                                                                                                                                                                              | `date`    | Sort collection by post attribute.                                                 |
| `slug`          | array of string                                                                                                                                                                                                                                                                                                                            |           | Limit result set to posts with one or more specific slugs.                         |
| `status`        | array of `publish`, `future`, `draft`, `pending`, `private`, `trash`, `auto-draft`, `inherit`, `request-pending`, `request-confirmed`, `request-failed`, `request-completed`, `in-progress`, `failed`, `wc-pending`, `wc-processing`, `wc-on-hold`, `wc-completed`, `wc-cancelled`, `wc-refunded`, `wc-failed`, `wc-checkout-draft`, `any` | `publish` | Limit result set to posts assigned one or more statuses.                           |
| `categories`    | array of string or number or boolean or integer or null                                                                                                                                                                                                                                                                                    |           | Limit result set to items with specific terms assigned in the categories taxonomy. |
| `tags`          | array of string or number or boolean or integer or null                                                                                                                                                                                                                                                                                    |           | Limit result set to items with specific terms assigned in the tags taxonomy.       |
| `sticky`        | boolean                                                                                                                                                                                                                                                                                                                                    |           | Limit result set to items that are sticky.                                         |
| `ignore_sticky` | boolean                                                                                                                                                                                                                                                                                                                                    | `true`    | Whether to ignore sticky posts or not.                                             |
| `format`        | array of `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`                                                                                                                                                                                                                                      |           | Limit result set to items assigned one or more given formats.                      |

</details>

<details>

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

> Search and filter blog posts with pagination. Use when you need a post ID, or to find, list or count posts.

</details>

## Update Post

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

Update a blog post; only the fields you pass change.

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

<details>

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

| Parameter        | Type                                                                                                                                                                                                             | Description                                                 |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `slug`           | string                                                                                                                                                                                                           | An alphanumeric identifier for the post unique to its type. |
| `status`         | one of `publish`, `future`, `draft`, `pending`, `private`, `in-progress`, `failed`, `wc-pending`, `wc-processing`, `wc-on-hold`, `wc-completed`, `wc-cancelled`, `wc-refunded`, `wc-failed`, `wc-checkout-draft` | A named status for the post.                                |
| `password`       | string                                                                                                                                                                                                           | A password to protect access to the content and excerpt.    |
| `title`          | string or object                                                                                                                                                                                                 | The title for the post.                                     |
| `content`        | string or object                                                                                                                                                                                                 | The content for the post.                                   |
| `author`         | integer                                                                                                                                                                                                          | The ID for the author of the post.                          |
| `excerpt`        | string or object                                                                                                                                                                                                 | The excerpt for the post.                                   |
| `featured_media` | integer                                                                                                                                                                                                          | The ID of the featured media for the post.                  |
| `comment_status` | one of `open`, `closed`                                                                                                                                                                                          | Whether or not comments are open on the post.               |
| `ping_status`    | one of `open`, `closed`                                                                                                                                                                                          | Whether or not the post can be pinged.                      |
| `format`         | one of `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`                                                                                                              | The format for the post.                                    |
| `sticky`         | boolean                                                                                                                                                                                                          | Whether or not the post should be treated as sticky.        |
| `template`       | string                                                                                                                                                                                                           | The theme file to use to display the post.                  |
| `categories`     | array of integer                                                                                                                                                                                                 | The terms assigned to the post in the category taxonomy.    |
| `tags`           | array of integer                                                                                                                                                                                                 | The terms assigned to the post in the post\_tag taxonomy.   |

</details>

<details>

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

> Update a blog post; only the fields you pass change. Use when asked to edit, publish, schedule or recategorise a post. Send HTML or block markup; HTML is converted to blocks. Needs `id` from `hostinger-ai/posts-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)
