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.

ToolREST endpointAnnotations
list_postsGET /v1/postsread, idempotent
get_postGET /v1/posts/{postId}read, idempotent
update_postPATCH /v1/posts/{postId}write, non-destructive
list_comment_threadsGET /v1/posts/{postId}/threadsread, idempotent
get_comment_threadGET /v1/posts/{postId}/threads/{threadId}read, idempotent
update_comment_threadPATCH /v1/posts/{postId}/threads/{threadId}write, non-destructive
publish_commentPOST /v1/posts/{postId}/commentswrite, public
reply_to_commentPOST /v1/posts/{postId}/threads/{threadId}/replieswrite, public
send_private_replyPOST /v1/posts/{postId}/threads/{threadId}/private-replieswrite
moderate_commentPOST /v1/posts/{postId}/comments/{commentId}/moderationwrite, destructive
send_thread_to_agentPOST /v1/posts/{postId}/threads/{threadId}/send-to-agentwrite

All of them accept workspace when the credential has several workspaces.


list_posts

FieldTypeDefaultDescription
limit1-10025Posts per page.
pageTokenstring—nextPageToken from the previous response.
channelIdstring—Comment channel (igc- / fbc-). Cannot be combined with platform.
platform"instagram" \| "facebook"—
startDate, endDateISO 8601—Latest activity range.

get_post

FieldTypeRequiredDescription
postIdstringyesPost id.

update_post

FieldTypeRequiredDescription
postIdstringyes
operation"automatic" \| "supervised"at least onesupervised pauses the agent; automatic resumes it (new comments only).
agentIdstring \| nullat least oneThe post's own agent; null goes back to the channel's.

list_comment_threads

One filter at a time among status, needsReply, operation, and owner.

FieldTypeDefaultDescription
postIdstring—Required.
limit1-10025
pageTokenstring—
sortBy"rootCreatedAt" \| "lastCommentAt"rootCreatedAt
status"open" \| "resolved"—
needsReplyboolean—true: the last comment is from the person and nobody has answered.
operation"automatic" \| "supervised" \| "assistance"—Only threads with their own value.
owneremail—Thread owner.

get_comment_thread

FieldTypeRequiredDescription
postIdstringyes
threadIdstringyesRoot comment id.

update_comment_thread

FieldTypeRequiredDescription
postId, threadIdstringyes
status"open" \| "resolved"at least oneReopens or resolves.
operation"automatic" \| "supervised" \| nullat least onePauses or resumes the agent on the thread; null inherits from the post; supervised accepts an assistance.
ownersemail[]at least oneReplaces the owner list.

publish_comment

FieldTypeRequiredDescription
postIdstringyes
messagestringyesComment text.
attachmentUrlURL https—Facebook only: JPG, PNG, or GIF image up to 10 MB.

reply_to_comment

FieldTypeRequiredDescription
postId, threadIdstringyes
messagestringyesReply text.
parentCommentIdstring—Thread comment you reply to. Defaults to the root.

send_private_reply

Meta allows one private reply per comment and only within 7 days.

FieldTypeRequiredDescription
postId, threadIdstringyes
messagestring (max 1000)yesDirect message.
commentIdstring—Comment you answer. Defaults to the root.
publicNoticestring—Public comment announcing the private message.

moderate_comment

FieldTypeRequiredDescription
postId, commentIdstringyes
action"hide" \| "unhide" \| "delete" \| "spam" \| "unspam"yesdelete cannot be undone; spam also blocks the contact.

send_thread_to_agent

FieldTypeRequiredDescription
postId, threadIdstringyes
dryRunboolean—true only reports what would be sent.