Documentation Index
Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt
Use this file to discover all available pages before exploring further.
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). |
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). |
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). |
| 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.