> ## 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

> All PostSyncer MCP tool names: workspaces, accounts, labels, campaigns, posts, media, folders, comments, analytics.

# 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](/api-reference/introduction) where the same action exists over REST.

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

## 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).                                                                                                                                                                        |

<Note>
  **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](/api-reference/posts/create#platform-requirements-for-cover-images).
</Note>

<Note>
  **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](/api-reference/posts/create#first-comments).
</Note>

## 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:

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

## Related REST docs

Each tool maps to REST routes under [API reference](/api-reference/introduction). Parameters and validation follow the same rules.