Documentation Index
Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
Use this file to discover all available pages before exploring further.
This page lists every tool available through the TryPost MCP server. Your AI assistant can call any of these tools to manage your TryPost account.
Recommended workflow
To create and publish a post end-to-end:
list-social-accounts-tool — discover connected accountslist-content-types-tool — discover valid content_type per platform with limitscreate-post-tool — create the draft with content + chosen platformsattach-media-from-url-tool (optional) — attach images or videos from public URLspreview-post-tool (optional) — see how each platform will render before publishingpublish-post-tool — publish immediately or schedule for a future timeget-post-metrics-tool (after published) — fetch engagement metrics
Posts
| Tool | Description |
|---|
| list-posts-tool | List posts for the current workspace, ordered by scheduled date (newest first). Supports filters: status (draft | scheduled | published | failed), search (case-insensitive substring on content), limit (1–100, default 50). |
| get-post-tool | Get a specific post by ID with all its platform entries, media, and labels. |
| create-post-tool | Create a draft post. Accepts content, scheduled_at (ISO 8601), label_ids[], and platforms[] — each entry has social_account_id + content_type. Cross-validates that the content_type matches the account’s platform. |
| update-post-tool | Update a draft: content, scheduled_at, status (draft | scheduled), labels, and which platforms are enabled. Cannot edit a published post. |
| publish-post-tool | Publish a draft — immediately or scheduled for a future time. Requires at least one enabled platform. Marked IsDestructive so the AI confirms with you first. |
| preview-post-tool | Preview how the post will render on each enabled platform — applies platform-specific sanitization (length truncation, etc.) without publishing. |
| attach-media-from-url-tool | Download images or videos from public URLs and attach them to a post. Up to 10 URLs per call. Per-file size caps: 10 MB for images, 1 GB for videos. Allowed types are intersected with the enabled platforms (e.g. video rejected if no enabled platform supports it). |
| delete-post-tool | Delete a post permanently. Marked IsDestructive. |
| get-post-metrics-tool | Fetch engagement metrics (likes, comments, shares, etc.) for a published post across every platform. Returns unsupported entries for platforms that don’t expose post-level metrics. |
| Tool | Description |
|---|
| list-content-types-tool | List valid content_type values per social platform plus their constraints — max_content_length, recommended_content_length, max_media_count, requires_media, default_content_type, allowed_media_types. Use this before create-post-tool / update-post-tool so the AI doesn’t guess. |
Signatures
| Tool | Description |
|---|
| list-signatures-tool | List all signatures for the current workspace. Signatures are reusable text blocks (hashtags, links, custom text) that can be appended to posts. |
| create-signature-tool | Create a new signature with a name and content (hashtags, links, custom text — anything you want to append to posts). |
| update-signature-tool | Update a signature’s name or content. |
| delete-signature-tool | Delete a signature. Marked IsDestructive. |
Labels
| Tool | Description |
|---|
| list-labels-tool | List all labels for the current workspace. Each label has a name and hex color. |
| create-label-tool | Create a new label with a name and hex color (e.g. #FF5733). |
| update-label-tool | Update a label’s name or color. |
| delete-label-tool | Delete a label. Detaches it from all posts that referenced it. Marked IsDestructive. |
Social accounts
| Tool | Description |
|---|
| list-social-accounts-tool | List all connected social accounts for the current workspace (LinkedIn, X, Instagram, etc.). Returns id, platform, display_name, username, is_active, status. |
| toggle-social-account-tool | Toggle a social account active/inactive. When inactive, the account is skipped during publishing. |
Workspace
| Tool | Description |
|---|
| get-workspace-tool | Get the current workspace details (id, name, timestamps). |
API keys
| Tool | Description |
|---|
| list-api-keys-tool | List Personal Access Tokens for the current workspace. Returns metadata only — the secret token value is shown only once at creation. OAuth-flow tokens (e.g. ChatGPT MCP sessions) are excluded. |
| create-api-key-tool | Create a new Personal Access Token. The plain token is returned once — store it immediately, it cannot be retrieved later. |
| delete-api-key-tool | Revoke a Personal Access Token. The current OAuth session token cannot be revoked through this tool. Marked IsDestructive. |
Notes
- Workspace scoping — every tool operates on the user’s currently-selected workspace. To act on a different workspace, switch it in the TryPost UI (or, for personal API tokens, create a new key in that workspace).
- Cross validation —
create-post-tool and update-post-tool reject mismatched combos (e.g. content_type=x_post on a LinkedIn account). Inactive social accounts are also rejected at validation time.
- Destructive tools — operations that delete data or publish to the world (
publish-post-tool, delete-*) are marked IsDestructive, which lets the AI client (ChatGPT, Claude Desktop, etc.) prompt you for confirmation before executing.
