Referencia de tools MCP — Documentación de Antwork

El catálogo

37 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. Hay dos tools más, internas de los iframes, que no se listan aquí: el modelo nunca debe llamarlas.

Identidad y workspaces

Tool	Acceso	Qué hace
whoami	Read	Perfil del usuario autenticado.
list_workspaces	Read	Lista todos los workspaces a los que pertenece el usuario. Muestra el flag `isDefault`.
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.
get_workspace_settings	Read	Identidad de marca, content guidelines, audiencia objetivo y preferencias por plataforma.
update_workspace_identity	Destructive	Renombra un workspace o actualiza su descripción.
update_workspace_settings	Destructive	Muta las content guidelines y settings de marca a nivel de workspace.

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	Traer posts recientes de una plataforma conectada. Esos posts SON la voz: el modelo los lee y los imita.

Posts — lectura

Tool	Acceso	Qué hace
get_post_context	Read	Bundle de contexto en una llamada: identidad del workspace, cuenta destino y sus posts recientes con engagement. Llámalo antes de escribir.
list_posts	Read	Lista borradores, programados, publicados y fallidos. Filtrable por estado y plataforma.
search_posts	Read	Búsqueda full-text en el cuerpo del post, hashtags y copy por plataforma.
get_post	Read	Un post con payload completo (texto, media, estado, URLs por plataforma).
get_post_history	Read	Histórico diario de métricas de un post publicado — likes / comentarios / shares / impressions.

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`.
update_post	Write	Muta cualquier campo de un post — texto, plataformas, hashtags, media, hora programada, copy por plataforma.
duplicate_post	Write	Clona un post existente en un borrador nuevo.
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 un borrador al instante en cada plataforma configurada. Espera hasta ~25 segundos para estado terminal y devuelve URLs por plataforma.
schedule_post	Destructive	Programa un borrador para un timestamp futuro. El servidor exige que la hora esté en el futuro.
retry_failed_post	Destructive	Reintenta una publicación que falló — útil cuando un token se ha refrescado o se han limpiado rate limits.
comment_post	Destructive	Comentar en un post de LinkedIn ya publicado con la cuenta conectada.

Analítica y planificación

Tool	Acceso	Qué hace
get_performance	Read	Totales agregados de engagement del workspace en una ventana dada.
get_engagement_history	Read	Series temporales diarias de engagement del workspace.
get_optimal_posting_times	Read	Ventanas de publicación sugeridas por plataforma inferidas del engagement histórico.
refresh_post_metrics	Write	Llama a las APIs de las plataformas en vivo para posts concretos y refresca las métricas cacheadas. Lento pero al minuto — usa `get_performance` para preguntas amplias.
get_calendar	Read	Posts programados y publicados agrupados por fecha. Renderiza como calendario interactivo en clientes con MCP Apps.

Media

Tool	Acceso	Qué hace
list_media	Read	Biblioteca de medios del workspace — imágenes, vídeo, PDFs.
get_media	Read	Un item de media con URL de descarga y metadatos por mime-type.
upload_media	Write	Ingesta un fichero desde una URL pública (p.ej. imagen generada por IA alojada en otro sitio). Es la ruta visible al LLM; el selector Add media del post-card usa upload_media_inline internamente con base64.
attach_chatgpt_file	Write	Adjunta un archivo que el usuario añadió al chat; se descarga en el servidor, así que su tamaño no consume contexto.
attach_media	Write	Adjunta items de media a un borrador.
delete_media	Destructive	Soft-delete de un item de media; no afecta a posts que ya lo referencian.
request_upload_url	Write	Generar una URL PUT firmada y de corta vida para subir directo. Para hosts sin selector de medios.
register_uploaded_media	Write	Validar una subida por PUT firmado y registrarla en la biblioteca de medios del workspace.

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.