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, and content[].cover_image for video covers). |
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). |
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. | 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). |
| 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.