# WordPress

Source: https://pilot.braike.com/en/docs/regies/wordpress

The 12 tools Pilot MCP serves for WordPress: 6 read-only, and 6 that write with the €29 plan, taken from the server.

Pilot MCP serves **6 read-only tools** for WordPress, on every plan. With the €29 plan, it also serves **4** that create or change and **2** that delete. Their names start with `wordpress_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 6 |
| [Create and change (€29)](#modification) | 4 |
| [Delete (€29)](#suppression) | 2 |

## Other tools [#autres]

### `wordpress_get_content` [#wordpress_get_content]

**WordPress: Get Content** · read-only · idempotent

Retrieves a full post or page (title, HTML content, excerpt, status, slug, categories). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | yes | Content type: 'post' (blog post) or 'page' (static page). Values: `"post"`, `"page"`. |
| `id` | `number` | yes | Content ID (from list\_content). |

### `wordpress_get_media` [#wordpress_get_media]

**WordPress: Get Media** · read-only · idempotent

Gets one item of the media library by id: title, alt\_text, caption, mime\_type, source\_url, post (the content it is attached to) and dates. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `number` | yes | ID of the media item. |

### `wordpress_get_site_info` [#wordpress_get_site_info]

**WordPress: Get Site Info** · read-only · idempotent

Identity of the WordPress site (name, description, detected API namespaces, e.g. 'wc/v3' if WooCommerce is active) and the connected user (roles). Call it first. Read-only.

No parameters.

### `wordpress_list_categories` [#wordpress_list_categories]

**WordPress: List Categories** · read-only · idempotent

Lists the site's categories ('category') or tags ('tag'): id, name, slug, number of posts. The IDs are used to filter and classify through list\_content and create\_content. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `taxonomy` | `string` | no | Taxonomy to list. Default: 'category'. Values: `"category"`, `"tag"`. |
| `search` | `string` | no |   |
| `per_page` | `number` | no |   |

### `wordpress_list_content` [#wordpress_list_content]

**WordPress: List Content** · read-only · idempotent

Lists the site's posts (post) or pages (page): id, title, status, slug, link, dates. Filters: full-text search, status, categories, pagination. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | yes | Content type: 'post' (blog post) or 'page' (static page). Values: `"post"`, `"page"`. |
| `search` | `string` | no | Full-text search. |
| `status` | `string` | no | Status filter, e.g. 'publish', 'draft', or 'publish,draft'. WordPress default: publish. |
| `categories` | `number[]` | no | Category IDs (posts only). |
| `per_page` | `number` | no | Results per page (default 10, max 100). |
| `page` | `number` | no | Page number. |
| `orderby` | `string` | no | Sort: 'date', 'modified', 'title'... |

### `wordpress_list_media` [#wordpress_list_media]

**WordPress: List Media** · read-only · idempotent

Lists the media in the library (id, title, source URL, MIME type, dimensions). The IDs are used as featured\_media or illustrations. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | `string` | no |   |
| `media_type` | `string` | no | Values: `"image"`, `"video"`, `"audio"`, `"application"`. |
| `per_page` | `number` | no |   |
| `page` | `number` | no |   |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `wordpress_create_content` [#wordpress_create_content]

**WordPress: Create Content** · create or change, €29 plan · creates an object on each call

Creates a post or a page. Defaults to 'draft' (not visible to the public), which is the recommended mode: create the draft, share the preview link, publish after approval. status='publish' puts the content LIVE immediately and requires confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | yes | Content type: 'post' (blog post) or 'page' (static page). Values: `"post"`, `"page"`. |
| `title` | `string` | yes | Title. |
| `content` | `string` | yes | HTML content (Gutenberg blocks are accepted as HTML). |
| `excerpt` | `string` | no | Excerpt (lead paragraph). |
| `slug` | `string` | no | URL slug (generated from the title if absent). |
| `status` | `string` | no | Status. 'draft' by default on creation. 'publish' requires confirm=true. Values: `"draft"`, `"publish"`, `"pending"`, `"private"`, `"future"`. |
| `categories` | `number[]` | no | Category IDs (posts only). |
| `parent` | `number` | no | ID of the parent page (pages only). |
| `confirm` | `boolean` | no | Required (true) if status=publish: confirms the immediate go-live. |

### `wordpress_update_content` [#wordpress_update_content]

**WordPress: Update Content** · create or change, €29 plan · creates an object on each call

Updates a post or a page (title, content, status...). If the target content is ALREADY published, or if the change publishes it (status='publish'), the change is publicly visible: confirm=true is required. Editing a draft needs no confirmation.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | yes | Content type: 'post' (blog post) or 'page' (static page). Values: `"post"`, `"page"`. |
| `id` | `number` | yes | ID of the content to update. |
| `title` | `string` | no |   |
| `content` | `string` | no | HTML content (replaces the existing content). |
| `excerpt` | `string` | no |   |
| `slug` | `string` | no |   |
| `status` | `string` | no | Status. 'draft' by default on creation. 'publish' requires confirm=true. Values: `"draft"`, `"publish"`, `"pending"`, `"private"`, `"future"`. |
| `categories` | `number[]` | no |   |
| `confirm` | `boolean` | no | Required (true) if the content is already published or if status=publish. |

### `wordpress_update_media` [#wordpress_update_media]

**WordPress: Update Media** · create or change, €29 plan · creates an object on each call

Updates the title, alternative text, caption or description of one media item by id. The file itself does not change (WordPress does not replace the file of a media item: upload another one).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `number` | yes | ID of the media item. |
| `title` | `string` | no |   |
| `alt_text` | `string` | no | Alternative text (accessibility and SEO). |
| `caption` | `string` | no |   |
| `description` | `string` | no |   |

### `wordpress_upload_media_from_url` [#wordpress_upload_media_from_url]

**WordPress: Upload Media from URL** · create or change, €29 plan · creates an object on each call

Downloads a file from a public URL and adds it to the site's media library (invisible as long as no published content uses it). Returns the ID to pass as featured\_media or to insert into the content.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `source_url` | `string` | yes | Public URL of the file to import (image, PDF...). |
| `filename` | `string` | yes | Target file name, e.g. 'visuel-campagne.png'. |
| `title` | `string` | no | Title of the media item in the library. |
| `alt_text` | `string` | no | Alternative text (accessibility and SEO, recommended). |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `wordpress_delete_content` [#wordpress_delete_content]

**WordPress: Delete Content** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one post or page by id. By default it goes to the trash, from where WordPress can restore it; force=true deletes it for good. Deleting published content, or deleting for good, takes it off the site: confirm=true is required. The result is checked: trash means status trash, force means deleted.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | yes | Content type: 'post' (blog post) or 'page' (static page). Values: `"post"`, `"page"`. |
| `id` | `number` | yes | ID of the content to delete. |
| `force` | `boolean` | no | true: delete for good, bypassing the trash. Default false (trash). |
| `confirm` | `boolean` | no | Required (true) if the content is published or if force=true. |

### `wordpress_delete_media` [#wordpress_delete_media]

**WordPress: Delete Media** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one media item by id, for good: WordPress has no trash for media. A published page that shows it loses the file, so confirm=true is always required. The result is checked (deleted: true).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `number` | yes | ID of the media item. |
| `confirm` | `boolean` | no | Required (true): the deletion is permanent. |
