Posts
Each tool calls a Posts endpoint. Writes run on behalf of
whoever connected the MCP client, with their permissions, and are billed and blocked exactly like the
inbox.
| Tool | REST endpoint | Annotations |
list_posts | GET /v1/posts | read, idempotent |
get_post | GET /v1/posts/{postId} | read, idempotent |
update_post | PATCH /v1/posts/{postId} | write, non-destructive |
list_comment_threads | GET /v1/posts/{postId}/threads | read, idempotent |
get_comment_thread | GET /v1/posts/{postId}/threads/{threadId} | read, idempotent |
update_comment_thread | PATCH /v1/posts/{postId}/threads/{threadId} | write, non-destructive |
publish_comment | POST /v1/posts/{postId}/comments | write, public |
reply_to_comment | POST /v1/posts/{postId}/threads/{threadId}/replies | write, public |
send_private_reply | POST /v1/posts/{postId}/threads/{threadId}/private-replies | write |
moderate_comment | POST /v1/posts/{postId}/comments/{commentId}/moderation | write, destructive |
send_thread_to_agent | POST /v1/posts/{postId}/threads/{threadId}/send-to-agent | write |
Advertencia
publish_comment and reply_to_comment publish on Meta right away and in public. Ask for
confirmation before calling them from an assistant.
All of them accept workspace when the credential has several workspaces.
list_posts
| Field | Type | Default | Description |
limit | 1-100 | 25 | Posts per page. |
pageToken | string | — | nextPageToken from the previous response. |
channelId | string | — | Comment channel (igc- / fbc-). Cannot be combined with platform. |
platform | "instagram" \| "facebook" | — | |
startDate, endDate | ISO 8601 | — | Latest activity range. |
get_post
| Field | Type | Required | Description |
postId | string | yes | Post id. |
update_post
| Field | Type | Required | Description |
postId | string | yes | |
operation | "automatic" \| "supervised" | at least one | supervised pauses the agent; automatic resumes it (new comments only). |
agentId | string \| null | at least one | The post's own agent; null goes back to the channel's. |
One filter at a time among status, needsReply, operation, and owner.
| Field | Type | Default | Description |
postId | string | — | Required. |
limit | 1-100 | 25 | |
pageToken | string | — | |
sortBy | "rootCreatedAt" \| "lastCommentAt" | rootCreatedAt | |
status | "open" \| "resolved" | — | |
needsReply | boolean | — | true: the last comment is from the person and nobody has answered. |
operation | "automatic" \| "supervised" \| "assistance" | — | Only threads with their own value. |
owner | email | — | Thread owner. |
| Field | Type | Required | Description |
postId | string | yes | |
threadId | string | yes | Root comment id. |
| Field | Type | Required | Description |
postId, threadId | string | yes | |
status | "open" \| "resolved" | at least one | Reopens or resolves. |
operation | "automatic" \| "supervised" \| null | at least one | Pauses or resumes the agent on the thread; null inherits from the post; supervised accepts an assistance. |
owners | email[] | at least one | Replaces the owner list. |
| Field | Type | Required | Description |
postId | string | yes | |
message | string | yes | Comment text. |
attachmentUrl | URL https | — | Facebook only: JPG, PNG, or GIF image up to 10 MB. |
| Field | Type | Required | Description |
postId, threadId | string | yes | |
message | string | yes | Reply text. |
parentCommentId | string | — | Thread comment you reply to. Defaults to the root. |
send_private_reply
Meta allows one private reply per comment and only within 7 days.
| Field | Type | Required | Description |
postId, threadId | string | yes | |
message | string (max 1000) | yes | Direct message. |
commentId | string | — | Comment you answer. Defaults to the root. |
publicNotice | string | — | Public comment announcing the private message. |
| Field | Type | Required | Description |
postId, commentId | string | yes | |
action | "hide" \| "unhide" \| "delete" \| "spam" \| "unspam" | yes | delete cannot be undone; spam also blocks the contact. |
send_thread_to_agent
| Field | Type | Required | Description |
postId, threadId | string | yes | |
dryRun | boolean | — | true only reports what would be sent. |