Herramientas

Herramienta	Tipo	Capacidad	Qué hace
site-context	Lectura	edit_posts	Tema, plantillas de página y presets de diseño
list-pages	Lectura	edit_pages	Páginas editables, paginadas
get-page	Lectura	edit_pages	El contenido en bloques de una página y su content_hash
save-page	Escritura	edit_pages	Crea o actualiza una página
list-posts	Lectura	edit_posts	Entradas editables del blog, paginadas
get-post	Lectura	edit_posts	El contenido, las categorías, las etiquetas y el content_hash de una entrada
save-post	Escritura	edit_posts	Crea o actualiza una entrada
list-terms	Lectura	edit_posts	Categorías y etiquetas
save-term	Escritura	manage_categories	Crea una categoría o etiqueta
search-content	Lectura	edit_posts	Busca en entradas y páginas, borradores incluidos
list-comments	Lectura	moderate_comments	Comentarios por estado
moderate-comment	Escritura, apagada por defecto	moderate_comments	Aprueba, deja pendiente, marca como spam o manda a la papelera un comentario
reply-comment	Escritura, apagada por defecto	moderate_comments	Responde un comentario
list-blocks	Lectura	edit_posts	Bloques disponibles en el insertador
list-patterns	Lectura	edit_posts	Patrones de bloques registrados
list-media	Lectura	upload_files	Imágenes de la biblioteca de medios, paginadas
site-health	Lectura	update_plugins	Versiones y actualizaciones disponibles

Para conectarse, el usuario además tiene que poder editar páginas (Editores y Administradores). La IA solo ve las herramientas que su usuario puede usar y que un administrador dejó activadas.

Todas corren como el usuario conectado y pasan por los endpoints REST de WordPress, así que se aplican los permisos por entrada.

site-context

Sin parámetros. Devuelve el nombre, la URL y el idioma del sitio, el tema activo (y si es un tema de bloques), las plantillas de página, los anchos de diseño (contentSize, wideSize) y los presets: colors, font_sizes, font_families y spacing.

list-pages

Parámetro	Tipo	Por defecto
search	string	—
page	entero ≥ 1	1
per_page	entero, 1–50	20

Devuelve pages (cada una con id, title, status y link), total y total_pages. Incluye páginas publicadas, borradores, pendientes, privadas y programadas. Un número de página después de la última devuelve una lista vacía.

get-page

Parámetro	Tipo
id	entero, obligatorio

Devuelve id, title, content (los bloques serializados, crudos), content_hash, excerpt, status, slug, link, template, modified_gmt y edit_url.

content_hash es la versión de la página: cambia cada vez que se guarda. Pasáselo a save-page como expected_content_hash.

save-page

Parámetro	Tipo	Notas
id	entero	Sin él, crea una página
expected_content_hash	string	Obligatorio para actualizar
title	string	Obligatorio para crear
content	string	Bloques serializados; reemplaza todo el cuerpo
excerpt	string
status	draft, pending, publish o private	Las páginas nuevas son draft
slug	string
template	string	Una plantilla de site-context
featured_media	entero ≥ 0	ID del adjunto

Devuelve id, el content_hash nuevo, status, link y edit_url. No repite el contenido.

Errores: content_conflict (la página cambió o no se mandó el hash), missing_title, non_block_content (HTML suelto), unknown_block (un bloque no registrado), más los errores de permisos propios de WordPress.

list-posts

Parámetro	Tipo	Por defecto
search	string	—
status	publish, draft, pending, private o future	todos
category	entero (ID de categoría)	—
tag	entero (ID de etiqueta)	—
page	entero ≥ 1	1
per_page	entero, 1–50	20

Devuelve posts (cada una con id, title, status, date y link), de la más nueva a la más vieja, más total y total_pages.

get-post

Parámetro	Tipo
id	entero, obligatorio

Devuelve id, title, content, content_hash, excerpt, status, date, slug, link, categories y tags (IDs), sticky, featured_media, template, modified_gmt y edit_url.

save-post

Parámetro	Tipo	Notas
id	entero	Sin él, crea una entrada
expected_content_hash	string	Obligatorio para actualizar
title	string	Obligatorio para crear
content	string	Bloques serializados; reemplaza todo el cuerpo
excerpt	string
status	draft, pending, publish, private o future	Las entradas nuevas son draft
date	string	En la zona horaria del sitio, como 2026-11-01T09:00:00. Con future, programa la entrada
slug	string
categories	array de enteros	IDs de categorías de list-terms
tags	array de enteros	IDs de etiquetas de list-terms
sticky	booleano	Fija la entrada arriba del blog
template	string
featured_media	entero ≥ 0	ID del adjunto

Devuelve id, el content_hash nuevo, status, link y edit_url. El hash también cubre categorías, etiquetas, sticky y date, así que cambiar cualquiera de ellos invalida el anterior. Los errores son los mismos que los de save-page, con missing_title para las entradas nuevas.

list-terms

Parámetro	Tipo	Por defecto
taxonomy	category o post_tag, obligatorio	—
search	string	—
page	entero ≥ 1	1
per_page	entero, 1–100	100

Devuelve terms (cada uno con id, name, slug, count y parent), total y total_pages. Incluye los términos sin entradas.

save-term

Parámetro	Tipo	Notas
taxonomy	category o post_tag, obligatorio
name	string, obligatorio
slug	string
parent	entero ≥ 0	Solo categorías
description	string

Crea el término y devuelve id, name, slug, taxonomy y created: true. Si ya existe uno con ese nombre, devuelve el existente con created: false en vez de fallar. Crear términos pide manage_categories (un Editor o un Administrador).

search-content

Parámetro	Tipo	Por defecto
search	string, obligatorio	—
per_page	entero, 1–20	10 (por tipo)

Devuelve results: primero las entradas y después las páginas, cada una con type (post o page), id, title, status y link. A diferencia de la búsqueda propia de WordPress, incluye borradores. Si el usuario no puede editar un tipo, ese tipo no aparece.

list-comments

Parámetro	Tipo	Por defecto
status	all (aprobados y pendientes), approve, hold (pendientes), spam o trash	all
post	entero (ID de entrada)	—
search	string	Texto a buscar en el nombre del autor o en el comentario
page	entero ≥ 1	1
per_page	entero, 1–50	20

Devuelve comments (cada uno con id, post, parent, author_name, date, status, content y link), total y total_pages. Nunca devuelve el email, la IP, el navegador ni la web de quien comentó.

moderate-comment

Apagada por defecto.

Parámetro	Tipo
id	entero, obligatorio
action	approve, hold, spam o trash, obligatorio

Devuelve id y el status nuevo. La papelera se puede deshacer desde WordPress; nada se borra para siempre.

reply-comment

Apagada por defecto.

Parámetro	Tipo
comment_id	entero, obligatorio
content	string, obligatorio

Publica una respuesta como el usuario conectado y devuelve id, status y link. Los visitantes la ven en el momento.

list-blocks

Parámetro	Tipo
name	string, como core/columns

Sin name, devuelve los bloques que aparecen en el insertador (name, title, description). Con name, devuelve ese bloque con sus attributes y supports.

list-patterns

Parámetro	Tipo
name	string

Sin name, devuelve los patrones registrados (name, title). Con name, también devuelve el content serializado del patrón.

list-media

Parámetro	Tipo	Por defecto
search	string	—
page	entero ≥ 1	1
per_page	entero, 1–50	20

Devuelve media (solo imágenes, cada una con id, title, url, alt y mime_type), total y total_pages.

site-health

Parámetro	Tipo	Descripción
refresh	boolean	Corre las pruebas de Salud del sitio en el momento. Por defecto false

Devuelve:

• wordpress: la version instalada y la update disponible, o null.
• php y database: su version.
• plugins y themes: cada uno con name, id (archivo del plugin o carpeta del tema), version, update (o null) y active.
• translation_updates: cuántas actualizaciones de traducciones esperan.
• last_checked: cuándo buscó actualizaciones WordPress por última vez (UTC). Las versiones y actualizaciones son de ese chequeo: la herramienta no busca actualizaciones nuevas.
• site_health: los números de Salud del sitio (good, recommended, critical), según el chequeo semanal de WordPress o la última vez que alguien abrió Herramientas → Salud del sitio. Con refresh, la herramienta corre las pruebas en ese momento, guarda los números nuevos como lo hace WordPress y suma issues: las pruebas que no pasaron, primero las críticas, cada una con test, status y label. Suele tardar unos segundos, y hasta un minuto en servidores donde se cuelgan las peticiones al propio sitio o a WordPress.org. WordPress además comprueba que puede llegar a WordPress.org. Para correr las pruebas, el usuario tiene que poder ver Herramientas → Salud del sitio.
• site_health_note: solo cuando site_health es null, porque WordPress todavía no corrió las pruebas. Explica cómo correrlas.
• https y multisite.

Es de solo lectura: nunca instala ni actualiza nada. Pide update_plugins (Administradores).