Publicaciones
Cada herramienta llama a un endpoint de Publicaciones . Las
operaciones de escritura se ejecutan a nombre de quien conectó el cliente MCP y respetan sus
permisos, así como las mismas reglas de cobro y bloqueo que la Bandeja.
| Tool | Endpoint REST | Anotaciones |
list_posts | GET /v1/posts | lectura, idempotente |
get_post | GET /v1/posts/{postId} | lectura, idempotente |
update_post | PATCH /v1/posts/{postId} | escritura, no destructiva |
list_comment_threads | GET /v1/posts/{postId}/threads | lectura, idempotente |
get_comment_thread | GET /v1/posts/{postId}/threads/{threadId} | lectura, idempotente |
update_comment_thread | PATCH /v1/posts/{postId}/threads/{threadId} | escritura, no destructiva |
publish_comment | POST /v1/posts/{postId}/comments | escritura, pública |
reply_to_comment | POST /v1/posts/{postId}/threads/{threadId}/replies | escritura, pública |
send_private_reply | POST /v1/posts/{postId}/threads/{threadId}/private-replies | escritura |
moderate_comment | POST /v1/posts/{postId}/comments/{commentId}/moderation | escritura, destructiva |
send_thread_to_agent | POST /v1/posts/{postId}/threads/{threadId}/send-to-agent | escritura |
Advertencia
publish_comment y reply_to_comment publican en Meta en ese momento y a la vista de todos. Pide
confirmación antes de llamarlas desde un asistente.
Todas aceptan workspace cuando la credencial tiene varios workspaces.
list_posts
| Campo | Tipo | Default | Descripción |
limit | 1-100 | 25 | Publicaciones por página. |
pageToken | string | — | nextPageToken de la respuesta anterior. |
channelId | string | — | Canal de comentarios (igc- / fbc-). No se combina con platform. |
platform | "instagram" \| "facebook" | — | |
startDate, endDate | ISO 8601 | — | Rango de última actividad. |
get_post
| Campo | Tipo | Requerido | Descripción |
postId | string | sí | id de la publicación. |
update_post
| Campo | Tipo | Requerido | Descripción |
postId | string | sí | |
operation | "automatic" \| "supervised" | al menos uno | supervised pausa al agente; automatic lo reanuda (solo para comentarios nuevos). |
agentId | string \| null | al menos uno | Agente propio de la publicación; null vuelve al del canal. |
Un solo filtro a la vez entre status, needsReply, operation y owner.
| Campo | Tipo | Default | Descripción |
postId | string | — | Requerido. |
limit | 1-100 | 25 | |
pageToken | string | — | |
sortBy | "rootCreatedAt" \| "lastCommentAt" | rootCreatedAt | |
status | "open" \| "resolved" | — | |
needsReply | boolean | — | true: el último comentario es de la persona y nadie ha contestado. |
operation | "automatic" \| "supervised" \| "assistance" | — | Solo hilos con valor propio. |
owner | email | — | Responsable del hilo. |
| Campo | Tipo | Requerido | Descripción |
postId | string | sí | |
threadId | string | sí | Id del comentario raíz. |
| Campo | Tipo | Requerido | Descripción |
postId, threadId | string | sí | |
status | "open" \| "resolved" | al menos uno | Reabre o resuelve. |
operation | "automatic" \| "supervised" \| null | al menos uno | Pausa o reanuda al agente en el hilo; null hereda de la publicación; supervised acepta una asistencia. |
owners | email[] | al menos uno | Reemplaza la lista de responsables. |
| Campo | Tipo | Requerido | Descripción |
postId | string | sí | |
message | string | sí | Texto del comentario. |
attachmentUrl | URL https | — | Solo Facebook: imagen JPG, PNG o GIF de hasta 10 MB. |
| Campo | Tipo | Requerido | Descripción |
postId, threadId | string | sí | |
message | string | sí | Texto de la respuesta. |
parentCommentId | string | — | Comentario del hilo al que respondes. Por defecto, la raíz. |
send_private_reply
Meta permite una respuesta privada por comentario y solo dentro de 7 días.
| Campo | Tipo | Requerido | Descripción |
postId, threadId | string | sí | |
message | string (máx 1000) | sí | Mensaje directo. |
commentId | string | — | Comentario que respondes. Por defecto, la raíz. |
publicNotice | string | — | Comentario público que avisa del mensaje privado. |
| Campo | Tipo | Requerido | Descripción |
postId, commentId | string | sí | |
action | "hide" \| "unhide" \| "delete" \| "spam" \| "unspam" | sí | delete no se puede deshacer; spam además bloquea al contacto. |
send_thread_to_agent
| Campo | Tipo | Requerido | Descripción |
postId, threadId | string | sí | |
dryRun | boolean | — | true solo dice qué se mandaría. |