Referencia de tools

Lo que tu asistente puede llamar, y cuáles de esas llamadas cambian algo.

Tools23

El catálogo

23 tools · 7 categorías

Las tools read-only nunca mutan estado; las destructivas (publish, delete, disconnect) lanzan confirmación explícita en los clientes que respetan la anotación destructiveHint.

Identidad y workspaces

Tool	Acceso	Qué hace
list_workspaces	Read	Lista los workspaces del usuario (con `isDefault`), la cuenta con sesión iniciada con su plan y su cuota de publicaciones, y las cuentas conectadas del workspace activo.
set_default_workspace	Write	Define o limpia el workspace por defecto para que las siguientes llamadas omitan `workspace_id`.
create_workspace	Write	Crea un nuevo workspace propiedad del usuario autenticado.
update_workspace	Destructive	Cambia el nombre, la web o el logo del workspace, su zona horaria y horas preferidas, o el etiquetado de enlaces salientes. Solo cambian los campos que se pasan; el resultado devuelve el workspace tal como quedó guardado.

Cuentas sociales

Tool	Acceso	Qué hace
list_social_accounts	Read	Todas las cuentas sociales conectadas con salud, expiración y plataforma.
get_connection_urls	Read	URLs OAuth para conectar nuevas cuentas sociales.
disconnect_social_account	Destructive	Revoca una cuenta social conectada; los tokens se borran del servidor.
fetch_platform_posts	Read	Lee los posts recientes de una cuenta directamente de la plataforma, con su engagement.

Posts — lectura

Tool	Acceso	Qué hace
get_post_context	Read	Bundle de contexto en una llamada: identidad y ajustes del workspace (zona horaria, horas preferidas), cuenta destino y sus posts recientes con engagement. Llámalo antes de escribir.
list_posts	Read	Lista borradores, programados, publicados y fallidos. Filtra por estado, palabra clave, plataforma, campaña o rango de fechas; `group_by_day` los ordena como un calendario con enlace a la página Calendario.
get_post	Read	Un post con payload completo (texto, media, estado, URLs por plataforma y un `editUrl` al compositor web).

Posts — escritura

Tool	Acceso	Qué hace
create_post	Write	Crea un borrador. No publica ni programa por sí mismo — encadena con `schedule_post` o `publish_post`.
create_campaign	Write	Redacta una idea para varias cuentas en una sola llamada, con un texto distinto por cuenta. Cada una es su propio post dentro de una campaña.
update_post	Write	Edita el texto, hashtags, media, hora programada o ajustes por plataforma de un post.
delete_post	Destructive	Soft-delete de un post. Para publicados, encola también el borrado en la plataforma cuando el conector lo soporta.

Posts — publicación

Tool	Acceso	Qué hace
publish_post	Destructive	Publica ya una publicación, varias o una campaña entera, y espera una sola vez la respuesta de las plataformas con las URLs. Una publicación que falló se reintenta con las mismas comprobaciones.
schedule_post	Destructive	Programa una publicación, varias o una campaña entera para una hora futura. La que no se pueda programar se informa por separado y las demás salen igual.

Analítica y planificación

Tool	Acceso	Qué hace
get_performance	Read	Engagement por post publicado y por plataforma en un periodo. Los totales van por plataforma, nunca sumados entre ellas.
get_engagement_history	Read	Engagement diario del workspace, o de un solo post con `post_id` (columnas acumuladas y diarias).

Media

Tool	Acceso	Qué hace
list_media	Read	Biblioteca de medios del workspace — imágenes, vídeo, PDFs.
add_media	Write	Añade media a la biblioteca y a todos los posts indicados en una sola llamada, desde una única fuente: un archivo adjunto en ChatGPT, una URL pública, una dirección de subida de un solo uso para un curl desde una shell o el sandbox de ejecución de código de Claude (permite api.antwork.io), o items que ya están en la biblioteca. Añade; no quita nada de lo que ya tiene el post.
attach_media	Write	Fija la lista exacta de media de un post: reordenar, quitar o vaciar con una lista vacía.
delete_media	Destructive	Soft-delete de un item de media; no afecta a posts que ya lo referencian.

El esquema de argumentos de cada tool se introspecciona en vivo desde el servidor — conecta un cliente y llama a tools/list para ver los JSON Schemas canónicos con campos requeridos y tipos.