MCP tools reference

These are the tool names your MCP client shows after it connects to PostSyncer. Each name matches the server implementation; behavior and request bodies align with API v1 where the same action exists over REST.

Tools such as delete-post, delete-account, and hide-comment change or remove live data. Only use them when the end user clearly asked for that outcome.

Workspaces

Tool	Purpose
`list-workspaces`	List workspaces (and related context your token can see).

Accounts

Tool	Purpose
`list-accounts`	List connected social accounts for selection when posting.
`delete-account`	Disconnect/remove a connected account (destructive).

Labels

Tool	Purpose
`list-labels`	List labels.
`create-label`	Create a label.
`get-label`	Get one label.
`update-label`	Update a label.
`delete-label`	Delete a label.

Campaigns

Tool	Purpose
`list-campaigns`	List campaigns.
`create-campaign`	Create a campaign.
`get-campaign`	Get one campaign.
`update-campaign`	Update a campaign.
`delete-campaign`	Delete a campaign.

Posts

Tool	Purpose
`list-posts`	List posts.
`create-post`	Create / schedule a post (supports `repeatable_accounts` with `repeatable`, `content[].cover_image` for video covers, and `content[].is_first_comment` / `first_comment_delay` for first comments).
`get-post`	Get one post.
`get-post-by-url`	Get one post by full public permalink (`post_url`).
`get-post-by-platform-post-id`	Get one post by native platform id (`platform_post_id`).
`analyze-twitter-post`	Fetch any public X/Twitter URL, load replies, and answer a question with AI (same as `POST /posts/analyze-twitter`).
`update-post`	Update a post (supports `repeatable_accounts` with `repeatable`, and the same first-comment fields as create-post).
`update-post-auto-plug`	Enable/disable auto plug (engagement thresholds).
`update-post-comment-moderation`	Per-post comment moderation settings.
`update-post-contact-collection`	CRM contact collection (keyword rules or add_all).
`delete-post`	Delete a post (destructive).

Video cover images (content[0].cover_image): TikTok - video_cover_timestamp_ms only (frame from video). YouTube, Instagram, Facebook - thumbnail only (custom image upload). See Create post - platform requirements.

First comments: add a second content item with is_first_comment: true (and optional first_comment_delay in minutes). Schedules a first comment on Instagram, Facebook, LinkedIn, and YouTube only. If the same post also targets TikTok, Threads, or other networks, put links/CTAs you need everywhere in the main caption (or use per-platform content when available). See Create post - first comments.

Media

Tool	Purpose
`list-media`	Paginated library items; optional `workspace_id`, `folder_id`, `root_only`.
`get-media`	Get one item by `media_id`.
`upload-media-from-url`	Import URLs into the library (`workspace_id`, `urls`, optional `folder_id`).
`upload-media-file`	Upload binary as base64 (`workspace_id`, `file_base64`, `filename`, optional `mime_type`, `folder_id`); same validation as `POST /media/upload/file`. Prefer REST multipart for very large files.
`delete-media`	Delete one item by `media_id` (destructive).

Folders

Tool	Purpose
`list-folders`	List media folders; optional `workspace_id`, `parent_id`, `root`.
`create-folder`	Create a folder (`workspace_id`, `name`, optional `color`, `parent_id`).
`get-folder`	Get one folder by `folder_id`.
`update-folder`	Update `folder_id` plus at least one of `name`, `color`, `parent_id`.
`delete-folder`	Delete a folder (destructive).

Comments

Tool	Purpose
`list-comments`	List comments.
`sync-comments-from-platforms`	Pull comments from platforms into PostSyncer.
`create-comment`	Create a reply / comment.
`get-comment`	Get one comment.
`update-comment`	Update a comment.
`delete-comment`	Delete a comment (destructive).
`hide-comment`	Hide a comment on the platform.

Analytics

Tool	Purpose
`get-analytics-summary`	Summary analytics.
`get-analytics-workspace`	Workspace-level analytics.
`get-analytics-post`	Post-level analytics.
`get-analytics-account`	Account-level analytics.
`sync-post-analytics`	Refresh analytics for a post.

Typical workflow

A sensible order for agents:

list-workspaces → choose workspace_id.
list-accounts → choose account IDs for publishing.
Optionally list-labels / list-campaigns.
Optionally list-folders / list-media or upload-media-from-url / upload-media-file for assets.
create-post, or comment/analytics tools as needed.

Each tool maps to REST routes under API reference. Parameters and validation follow the same rules.

Start here

Guides

MCP

API reference

MCP tools reference

MCP tools reference

Workspaces

Accounts

Labels

Campaigns

Posts

Media

Folders

Comments

Analytics

Typical workflow

​MCP tools reference

​Workspaces

​Accounts

​Labels

​Campaigns

​Posts

​Media

​Folders

​Comments

​Analytics

​Typical workflow

​Related REST docs

MCP tools reference

Workspaces

Accounts

Labels

Campaigns

Posts

Media

Folders

Comments

Analytics

Typical workflow

Related REST docs