Skip to main content
Glama

Queue a draft post

create_draft

Save a post as a DRAFT in the user's posthell queue, with any photos or videos and per-network settings (Instagram Reel cover, YouTube title/tags). Nothing is published by this tool: the user approves it in the dashboard. Optionally propose a publish time. Warnings in the result are what would stop it publishing; fix them by calling again.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "create_draft"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyNoThe caption. Optional when the post is a photo or video. For YouTube it becomes the description unless overrides.youtube is set.
groupNoPost to every connected account in this group, by name (e.g. "Bakery"). list_accounts shows the groups. Combine with platforms to send to only some of the group's networks.
mediaNoPhotos or videos, in order. One video = an Instagram Reel / a YouTube video.
accountsNoPost to these accounts, by handle (e.g. "posthell_bakery") or id from list_accounts. Default: every connected account (narrowed by platforms).
overridesNoA caption of its own for a network, used instead of body there. For YouTube this is the video description.
platformsNoOnly these networks.
proposedTimeNoSuggested publish time, ISO 8601. Only a suggestion - pre-fills the user's scheduler.
platformOptionsNoSettings for each network, keyed by network. Only the networks the post goes to are used.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / group
      Added value: +{
      +  "description": "Post to every connected account in this group, by name (e.g. \"Bakery\"). list_accounts shows the groups. Combine with platforms to send to only some of the group's networks.",
      +  "maxLength": 60,
      +  "type": "string"
      +}
  2. Changed8 schema fields changed
    • addedInput schema / properties / accounts
      Added value: +{
      +  "description": "Post to these accounts, by handle (e.g. \"posthell_bakery\") or id from list_accounts. Default: every connected account (narrowed by platforms).",
      +  "items": {
      +    "maxLength": 120,
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedInput schema / properties / body / description
      Previous value: -"The post text"New value: +"The caption. Optional when the post is a photo or video. For YouTube it becomes the description unless overrides.youtube is set."
    • removedInput schema / properties / body / minLength
      Removed value: -1
    • addedInput schema / properties / media
      Added value: +{
      +  "description": "Photos or videos, in order. One video = an Instagram Reel / a YouTube video.",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      {
      +        "properties": {
      +          "alt": {
      +            "description": "Alt text describing it, for networks that show it",
      +            "maxLength": 500,
      +            "type": "string"
      +          },
      +          "type": {
      +            "description": "Read from the file extension when omitted",
      +            "enum": [
      +              "image",
      +              "video"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "https URL: a mediaUrl from get_upload_url, or a public file",
      +            "maxLength": 2048,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "url"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / overrides
      Added value: +{
      +  "description": "A caption of its own for a network, used instead of body there. For YouTube this is the video description.",
      +  "properties": {
      +    "bluesky": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "discord": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "facebook": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "googlebusiness": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "instagram": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "linkedin": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "pinterest": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "reddit": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "telegram": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "threads": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "tiktok": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "whatsapp": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "x": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    },
      +    "youtube": {
      +      "maxLength": 5000,
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / platformOptions
      Added value: +{
      +  "description": "Settings for each network, keyed by network. Only the networks the post goes to are used.",
      +  "properties": {
      +    "facebook": {
      +      "description": "Facebook options",
      +      "properties": {
      +        "contentType": {
      +          "description": "Post as. A normal post on your Page. One vertical video, shown in Reels. Shows for 24 hours, full screen. One photo or video, no caption. Values: \"reel\" = Reel, \"story\" = Story. Omit for a normal post.",
      +          "enum": [
      +            "reel",
      +            "story"
      +          ],
      +          "type": "string"
      +        },
      +        "title": {
      +          "description": "Reel title. A separate title shown on the Reel, apart from the caption.",
      +          "maxLength": 255,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "instagram": {
      +      "description": "Instagram options",
      +      "properties": {
      +        "audioName": {
      +          "description": "Audio name. Names the Reel's original sound. Instagram ignores it when the Reel uses licensed music. Video posts only.",
      +          "maxLength": 100,
      +          "type": "string"
      +        },
      +        "collaborators": {
      +          "description": "Collaborators. Invite up to 3 Instagram accounts as co-authors, so the post appears on their profile too. They get an invite and the post shows on their profile once they accept.",
      +          "items": {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          "maxItems": 3,
      +          "type": "array"
      +        },
      +        "contentType": {
      +          "description": "Post as. A photo or carousel goes to your feed, a video posts as a Reel. Shows for 24 hours, full screen. One photo or video, no caption. Values: \"story\" = Story. Omit for a normal post.",
      +          "enum": [
      +            "story"
      +          ],
      +          "type": "string"
      +        },
      +        "coverAtMs": {
      +          "description": "Cover frame (ms). Video posts only.",
      +          "maximum": 3600000,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "coverUrl": {
      +          "description": "Cover image. Video posts only. An https URL.",
      +          "maxLength": 2048,
      +          "type": "string"
      +        },
      +        "reelsOnly": {
      +          "description": "Show only in the Reels tab. Leave it off and the Reel also shows on your profile grid. Video posts only.",
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "pinterest": {
      +      "description": "Pinterest options",
      +      "properties": {
      +        "boardId": {
      +          "description": "Board. Pins must go to a board. Pick which one this pin lands on. Omit to use the network's default.",
      +          "maxLength": 200,
      +          "type": "string"
      +        },
      +        "link": {
      +          "description": "Destination link. Where the pin sends people, usually your product or article page. Without it the pin links nowhere. An https URL.",
      +          "maxLength": 2048,
      +          "type": "string"
      +        },
      +        "title": {
      +          "description": "Pin title. Pinterest is a search engine, so a clear keyword-led title matters more than the caption.",
      +          "maxLength": 100,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "reddit": {
      +      "description": "Reddit options",
      +      "properties": {
      +        "flairText": {
      +          "description": "Flair.",
      +          "maxLength": 64,
      +          "type": "string"
      +        },
      +        "nsfw": {
      +          "description": "Mark NSFW.",
      +          "type": "boolean"
      +        },
      +        "spoiler": {
      +          "description": "Mark spoiler.",
      +          "type": "boolean"
      +        },
      +        "subreddit": {
      +          "description": "Subreddit. Posts go to your default subreddit unless set. Flair-required subs reject posts without a flair.",
      +          "maxLength": 100,
      +          "type": "string"
      +        },
      +        "title": {
      +          "description": "Title.",
      +          "maxLength": 300,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "tiktok": {
      +      "description": "TikTok options",
      +      "properties": {
      +        "allowComment": {
      +          "description": "Allow comments. Default true.",
      +          "type": "boolean"
      +        },
      +        "allowDuet": {
      +          "description": "Allow duets. Video posts only. Default true.",
      +          "type": "boolean"
      +        },
      +        "allowStitch": {
      +          "description": "Allow stitches. Video posts only. Default true.",
      +          "type": "boolean"
      +        },
      +        "autoAddMusic": {
      +          "description": "Let TikTok add music. Photo posts only.",
      +          "type": "boolean"
      +        },
      +        "commercialContentType": {
      +          "description": "Promotional?. TikTok labels promotional posts. Promoting your own business counts. Values: \"none\" = No, \"brand_organic\" = Yes, my own business, \"brand_content\" = Yes, a paid partnership.",
      +          "enum": [
      +            "none",
      +            "brand_organic",
      +            "brand_content"
      +          ],
      +          "type": "string"
      +        },
      +        "draft": {
      +          "description": "Send to my TikTok inbox instead. It lands in your TikTok inbox so you can add a sound and post it from the app.",
      +          "type": "boolean"
      +        },
      +        "privacyLevel": {
      +          "description": "Who can see it. TikTok asks you to choose this for every post. Required for TikTok. It must be one the account allows.",
      +          "enum": [
      +            "PUBLIC_TO_EVERYONE",
      +            "MUTUAL_FOLLOW_FRIENDS",
      +            "FOLLOWER_OF_CREATOR",
      +            "SELF_ONLY"
      +          ],
      +          "type": "string"
      +        },
      +        "videoMadeWithAi": {
      +          "description": "Made with AI. Set for you when the post uses an image made with AI.",
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "youtube": {
      +      "description": "YouTube options",
      +      "properties": {
      +        "categoryId": {
      +          "description": "Category. Values: \"22\" = People & Blogs, \"26\" = Howto & Style, \"27\" = Education, \"28\" = Science & Technology, \"24\" = Entertainment, \"23\" = Comedy, \"1\" = Film & Animation, \"10\" = Music, \"15\" = Pets & Animals, \"17\" = Sports, \"19\" = Travel & Events, \"20\" = Gaming, \"25\" = News & Politics, \"29\" = Nonprofits & Activism, \"2\" = Autos & Vehicles.",
      +          "enum": [
      +            "1",
      +            "2",
      +            "10",
      +            "15",
      +            "17",
      +            "19",
      +            "20",
      +            "22",
      +            "23",
      +            "24",
      +            "25",
      +            "26",
      +            "27",
      +            "28",
      +            "29"
      +          ],
      +          "type": "string"
      +        },
      +        "coverAtMs": {
      +          "description": "Thumbnail frame (ms). Video posts only.",
      +          "maximum": 43200000,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "coverUrl": {
      +          "description": "Thumbnail image. Video posts only. An https URL.",
      +          "maxLength": 2048,
      +          "type": "string"
      +        },
      +        "madeForKids": {
      +          "description": "Made for kids.",
      +          "type": "boolean"
      +        },
      +        "madeWithAi": {
      +          "description": "Realistic content made with AI. Tick when it shows realistic people, places or events that were made or changed with AI. YouTube adds a label. Animation and graphics don't need it.",
      +          "type": "boolean"
      +        },
      +        "tags": {
      +          "description": "Tags. Search words for YouTube, comma-separated. Up to 500 characters in total.",
      +          "items": {
      +            "maxLength": 100,
      +            "type": "string"
      +          },
      +          "maxItems": 60,
      +          "type": "array"
      +        },
      +        "title": {
      +          "description": "Title.",
      +          "maxLength": 100,
      +          "type": "string"
      +        },
      +        "visibility": {
      +          "description": "Visibility.",
      +          "enum": [
      +            "public",
      +            "unlisted",
      +            "private"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / platforms / description
      Previous value: -"Limit to these platforms (default: all connected accounts)"New value: +"Only these networks."
    • removedInput schema / required
      Removed value: -[
      -  "body"
      -]
  3. Changed1 schema field changed
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "x",
      -  "linkedin",
      -  "instagram",
      -  "threads",
      -  "bluesky",
      -  "facebook",
      -  "tiktok",
      -  "youtube",
      -  "pinterest",
      -  "reddit",
      -  "telegram",
      -  "discord",
      -  "snapchat",
      -  "googlebusiness",
      -  "whatsapp"
      -]New value: +[
      +  "x",
      +  "linkedin",
      +  "instagram",
      +  "threads",
      +  "bluesky",
      +  "facebook",
      +  "tiktok",
      +  "youtube",
      +  "pinterest",
      +  "reddit",
      +  "telegram",
      +  "discord",
      +  "googlebusiness",
      +  "whatsapp"
      +]
  4. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly=false and destructive=false; the description adds genuinely new behavior: the draft is inert until dashboard approval, proposedTime is advisory only, and warnings indicate what would block publishing. It does not address idempotency (annotations say idempotent=false), so whether a retry creates a second draft is left unclear.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four tight sentences, front-loaded with the core action and scope before the non-publishing caveat and the warning-loop guidance. Nothing is padded, though the parenthetical example list is the least load-bearing part.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description usefully explains that results contain warnings that gate publishing, which is the key return-value insight for an agent. The remaining role of sibling tools (shape_post, get_upload_url) for input preparation is only partially covered via the schema's inline mention.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already carries the parameter burden and baseline 3 applies. The description restates a few highlights (media, Instagram Reel cover, YouTube title/tags) and echoes proposedTime's advisory nature, but adds no format or constraint detail beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Save a post as a DRAFT in the user's posthell queue') and enumerates the content it carries (photos/videos, per-network settings), which cleanly distinguishes it from publishing tools and from shaping siblings like shape_post.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear usage context: nothing is published here, the user approves in the dashboard, and the returned warnings are pre-publish blockers that should be fixed by re-calling. It does not, however, name siblings such as shape_post or get_upload_url as alternatives for pre-validation or media preparation, leaving some routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources