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. |
get-post | Get one post. |
update-post | Update a post. |
delete-post | Delete a post (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.
create-post, or comment/analytics tools as needed.
Each tool maps to REST routes under API reference. Parameters and validation follow the same rules.