Outils du connecteur MCP SPIP

`whoami`

Retourne l'auteur SPIP (id, nom, statut) associé à la clé API courante.

Aucun paramètre.

`list_rubriques`

Liste les rubriques. `parent` filtre sur la rubrique parente (0 = racine).

Paramètre	Type
`parent`	integer \| null	optionnel
`limite`	integer	optionnel

`get_rubrique`

Détaille une rubrique (titre, descriptif, texte, statut, `lang` et `langue_choisie` — `oui` si la langue est explicite, `non` si héritée).

Paramètre	Type
`id_rubrique`	integer	requis

`create_rubrique`

Crée une rubrique.

Paramètre	Type
`titre`	string	requis
`id_parent`	integer	optionnel
`descriptif`	string \| null	optionnel
`texte`	string \| null	optionnel
`lang`	string \| null	optionnel

`update_rubrique`

Modifie une rubrique. Seuls les champs fournis sont mis à jour.

Paramètre	Type
`id_rubrique`	integer	requis
`titre`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`texte`	string \| null	optionnel

`set_rubrique_lang`

Affecte la **langue** d'une rubrique (code ISO : `fr`, `en`, …) et la marque comme explicitement choisie (`langue_choisie = oui`) — miroir de `set_article_lang` pour les rubriques.

Paramètre	Type
`id_rubrique`	integer	requis
`lang`	string \| null	optionnel
`heriter`	boolean	optionnel

`list_articles`

Liste les articles.

Paramètre	Type
`id_rubrique`	integer \| null	optionnel
`statut`	string \| null	optionnel
`recherche`	string \| null	optionnel
`limite`	integer	optionnel

`get_article`

Détaille un article (tous les champs + auteurs liés).

Paramètre	Type
`id_article`	integer	requis

`create_article`

Crée un article dans une rubrique.

Paramètre	Type
`id_rubrique`	integer	requis
`titre`	string \| null	optionnel
`soustitre`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`chapo`	string \| null	optionnel
`nom_site`	string \| null	optionnel
`url_site`	string \| null	optionnel
`texte`	string \| null	optionnel

`update_article`

Modifie un article. Seuls les champs fournis sont mis à jour.

Paramètre	Type
`id_article`	integer	requis
`titre`	string \| null	optionnel
`soustitre`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`chapo`	string \| null	optionnel
`nom_site`	string \| null	optionnel
`url_site`	string \| null	optionnel
`texte`	string \| null	optionnel
`id_rubrique`	integer \| null	optionnel

`set_article_author`

Affecte un auteur à un article (ou le retire si `retirer=True`).

Paramètre	Type
`id_article`	integer	requis
`id_auteur`	integer	requis
`retirer`	boolean	optionnel

`set_article_status`

Change le workflow d'un article.

Paramètre	Type
`id_article`	integer	requis
`statut`	string	requis

`move_article`

Déplace un article dans une autre rubrique (`id_rubrique` cible).

Paramètre	Type
`id_article`	integer	requis
`id_rubrique`	integer	requis

`make_article_page`

Transforme un article en **page unique** (plugin SPIP « Pages ») : l'article est sorti de toute rubrique (`id_rubrique = 0`) et servi par le squelette dédié du plugin — typique pour les mentions légales, la page contact, etc.

Paramètre	Type
`id_article`	integer	requis

`set_article_lang`

Affecte la **langue** d'un article (code ISO : `fr`, `en`, `pt_br`, …) et la marque comme explicitement choisie (`langue_choisie`).

Paramètre	Type
`id_article`	integer	requis
`lang`	string	requis

`set_article_translation`

Désigne un article comme **traduction d'un autre** (groupe de traduction partagé via `id_trad`), ce qui alimente la navigation entre langues et le **hreflang**.

Paramètre	Type
`id_article`	integer	requis
`id_traduction_de`	integer \| null	optionnel
`retirer`	boolean	optionnel

`trash_article`

Met un article à la corbeille (statut « poubelle »).

Paramètre	Type
`id_article`	integer	requis

`get_faq`

Lit la **FAQ** d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) — fonctionnalité du plugin « Données structurées GEO (JSON-LD) », qui doit être actif sur le site.

Paramètre	Type
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel

`set_faq`

**Remplace** la FAQ d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) — plugin « Données structurées GEO (JSON-LD) » requis.

Paramètre	Type
`questions`	array	requis
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel

`add_document_from_url`

Ajoute un document/image à SPIP depuis une **URL** (idéal pour une image générée par DALL·E, ou tout lien) : le fichier est **téléchargé** dans SPIP et rattaché à un article (`id_article`) ou une rubrique (`id_rubrique`).

Paramètre	Type
`url`	string	requis
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel
`titre`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`credits`	string \| null	optionnel
`mode`	string	optionnel

`add_document_from_data`

Ajoute un document/image depuis des **données base64**, rattaché à un article ou une rubrique. **Réservé aux petits fichiers (≲ 10 Ko).**

Paramètre	Type
`filename`	string	requis
`content_base64`	string	requis
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel
`titre`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`credits`	string \| null	optionnel
`mode`	string	optionnel
`taille_attendue`	integer \| null	optionnel
`sha256`	string \| null	optionnel

`list_documents`

Liste la médiathèque (documents et images).

Paramètre	Type
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel
`media`	string \| null	optionnel
`extension`	string \| null	optionnel
`mode`	string \| null	optionnel
`recherche`	string \| null	optionnel
`limite`	integer	optionnel
`offset`	integer	optionnel

`get_document`

Détaille un document et **résout son emplacement** via le connecteur.

Paramètre	Type
`id_document`	integer	requis

`download_document`

Télécharge le **binaire** d'un document local et le renvoie encodé en base64.

Paramètre	Type
`id_document`	integer	requis

`unlink_document`

**Délie** un document d'un article (`id_article`) ou d'une rubrique (`id_rubrique`) **sans le supprimer** : le fichier et sa fiche restent dans la médiathèque SPIP, et ses rattachements à d'autres objets sont conservés.

Paramètre	Type
`id_document`	integer	requis
`id_article`	integer \| null	optionnel
`id_rubrique`	integer \| null	optionnel

`delete_document`

Supprime un document de la médiathèque.

Paramètre	Type
`id_document`	integer	requis
`definitif`	boolean	optionnel

`list_forms`

Liste les formulaires Formidable du site, avec leur nombre de réponses (hors corbeille).

Paramètre	Type
`statut`	string \| null	optionnel
`recherche`	string \| null	optionnel
`limite`	integer	optionnel

`get_form`

Détaille un formulaire Formidable, par `id_formulaire` ou par `identifiant` (slug).

Paramètre	Type
`id_formulaire`	integer \| null	optionnel
`identifiant`	string \| null	optionnel

`create_form`

Crée un formulaire Formidable (réservé aux administrateurs). Le formulaire est créé en statut « prop » : le publier ensuite via `set_form_status`.

Paramètre	Type
`titre`	string	requis
`saisies`	array	requis
`identifiant`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`message_retour`	string \| null	optionnel
`traitements`	object \| null	optionnel
`apres`	string \| null	optionnel
`url_redirect`	string \| null	optionnel

`update_form`

Modifie un formulaire Formidable. Seuls les champs fournis sont mis à jour ; `saisies` est un **remplacement total** — relire la structure via `get_form` et renvoyer la liste complète (en conservant les `identifiant` de saisies pour le suivi des champs).

Paramètre	Type
`id_formulaire`	integer	requis
`titre`	string \| null	optionnel
`saisies`	array \| null	optionnel
`identifiant`	string \| null	optionnel
`descriptif`	string \| null	optionnel
`message_retour`	string \| null	optionnel
`traitements`	object \| null	optionnel
`apres`	string \| null	optionnel
`url_redirect`	string \| null	optionnel
`confirmer_perte_champs`	boolean	optionnel

`set_form_status`

Change le statut d'un formulaire Formidable.

Paramètre	Type
`id_formulaire`	integer	requis
`statut`	string	requis

`list_form_responses`

Liste les réponses reçues par un formulaire Formidable (métadonnées : date, auteur, statut — pas le détail des champs, voir `get_form_response`).

Paramètre	Type
`id_formulaire`	integer	requis
`statut`	string	optionnel
`date_debut`	string \| null	optionnel
`date_fin`	string \| null	optionnel
`limite`	integer	optionnel
`offset`	integer	optionnel

`get_form_response`

Détaille une réponse à un formulaire Formidable : métadonnées (date, auteur, statut) et `champs` — liste `{nom, label, saisie, valeur}` avec les labels résolus depuis la structure du formulaire.

Paramètre	Type
`id_reponse`	integer	requis

`set_form_response_status`

Change le statut d'une réponse Formidable (modération) : `publie` | `prop` | `refuse` | `poubelle`. Repasser une réponse de `poubelle` à `publie` la restaure. (`attente` est réservé à la validation par email et refusé.)

Paramètre	Type
`id_reponse`	integer	requis
`statut`	string	requis

`delete_form_response`

Supprime une réponse à un formulaire Formidable.

Paramètre	Type
`id_reponse`	integer	requis
`definitif`	boolean	optionnel

`export_form_responses`

Exporte les réponses d'un formulaire Formidable en **CSV** (contenu texte renvoyé dans `contenu`), via l'export natif du plugin.

Paramètre	Type
`id_formulaire`	integer	requis
`statut`	string	optionnel
`date_debut`	string \| null	optionnel
`date_fin`	string \| null	optionnel
`cle_ou_valeur`	string	optionnel

Outils du connecteur

Identité

whoami

Rubriques

list_rubriques

get_rubrique

create_rubrique

update_rubrique

set_rubrique_lang

Articles

list_articles

get_article

create_article

update_article

set_article_author

set_article_status

move_article

make_article_page

set_article_lang

set_article_translation

trash_article

FAQ (JSON-LD)

get_faq

set_faq

Médiathèque

add_document_from_url

add_document_from_data

list_documents

get_document

download_document

unlink_document

delete_document

Divers

list_forms

get_form

create_form

update_form

set_form_status

list_form_responses

get_form_response

set_form_response_status

delete_form_response

export_form_responses