# WordPress

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

Les 12 outils que Pilot MCP sert pour WordPress : 6 en lecture, et 6 qui écrivent avec l'offre à 29 €, tirés du serveur.

Pilot MCP sert **6 outils de lecture** pour WordPress, à tous les forfaits. Avec l'offre à 29 €, il sert en plus **4** qui créent ou modifient et **2** qui suppriment. Leur nom commence par `wordpress_`.

<Callout title="Ce que dit chaque fiche">
Le nom, la description et les paramètres viennent de la liste que le serveur sert à votre assistant (`tools/list`). Les descriptions sont en anglais : c'est le texte que votre assistant reçoit. Votre assistant n'a pas à remplir les accès à la régie : Pilot les ajoute à chaque appel.
</Callout>

<Callout title="Écrire et supprimer">
Les outils qui écrivent ne sont servis qu'avec le forfait à 29 € : votre assistant y crée, modifie, met en pause et supprime, sans niveau à choisir à la connexion. Au forfait Gratuit, il ne les voit pas. Une modification qui passe un objet au statut supprimé ou archivé compte comme une suppression, et une suppression ne vise qu'un objet à la fois. Les modifications s'appliquent directement dans la régie : Pilot relit l'objet avant et après l'écriture, et la note dans votre espace. Voir [Lire et écrire](/docs/limites-et-forfaits#ecritures).
</Callout>

## Familles d'outils [#familles]

| Famille | Outils |
| --- | ---: |
| [Autres outils](#autres) | 6 |
| [Créer et modifier (29 €)](#modification) | 4 |
| [Supprimer (29 €)](#suppression) | 2 |

## Autres outils [#autres]

### `wordpress_get_content` [#wordpress_get_content]

**WordPress: Get Content** · lecture · rejouable

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `content_type` | `string` | oui | Content type: 'post' (blog post) or 'page' (static page). Valeurs : `"post"`, `"page"`. |
| `id` | `number` | oui | Content ID (from list\_content). |

### `wordpress_get_media` [#wordpress_get_media]

**WordPress: Get Media** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `id` | `number` | oui | ID of the media item. |

### `wordpress_get_site_info` [#wordpress_get_site_info]

**WordPress: Get Site Info** · lecture · rejouable

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.

Aucun paramètre.

### `wordpress_list_categories` [#wordpress_list_categories]

**WordPress: List Categories** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `taxonomy` | `string` | non | Taxonomy to list. Default: 'category'. Valeurs : `"category"`, `"tag"`. |
| `search` | `string` | non |   |
| `per_page` | `number` | non |   |

### `wordpress_list_content` [#wordpress_list_content]

**WordPress: List Content** · lecture · rejouable

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

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

### `wordpress_list_media` [#wordpress_list_media]

**WordPress: List Media** · lecture · rejouable

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `search` | `string` | non |   |
| `media_type` | `string` | non | Valeurs : `"image"`, `"video"`, `"audio"`, `"application"`. |
| `per_page` | `number` | non |   |
| `page` | `number` | non |   |

## Créer et modifier (29 €) [#modification]

Servis avec le forfait à 29 €.

### `wordpress_create_content` [#wordpress_create_content]

**WordPress: Create Content** · création ou modification, forfait à 29 € · crée un objet à chaque appel

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.

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

### `wordpress_update_content` [#wordpress_update_content]

**WordPress: Update Content** · création ou modification, forfait à 29 € · crée un objet à chaque appel

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.

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

### `wordpress_update_media` [#wordpress_update_media]

**WordPress: Update Media** · création ou modification, forfait à 29 € · crée un objet à chaque appel

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).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `id` | `number` | oui | ID of the media item. |
| `title` | `string` | non |   |
| `alt_text` | `string` | non | Alternative text (accessibility and SEO). |
| `caption` | `string` | non |   |
| `description` | `string` | non |   |

### `wordpress_upload_media_from_url` [#wordpress_upload_media_from_url]

**WordPress: Upload Media from URL** · création ou modification, forfait à 29 € · crée un objet à chaque appel

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.

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

## Supprimer (29 €) [#suppression]

Servis avec le forfait à 29 €. Une suppression ne vise qu'un objet à la fois.

### `wordpress_delete_content` [#wordpress_delete_content]

**WordPress: Delete Content** · suppression, forfait à 29 €, un objet à la fois · crée un objet à chaque appel

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.

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

### `wordpress_delete_media` [#wordpress_delete_media]

**WordPress: Delete Media** · suppression, forfait à 29 €, un objet à la fois · crée un objet à chaque appel

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).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `id` | `number` | oui | ID of the media item. |
| `confirm` | `boolean` | non | Required (true): the deletion is permanent. |
