Propose a post
Draft/propose a post for one of the brand's connected accounts (see get_capabilities for the live list and what each one can do).
POST /api/v1/propose_post · MCP tool propose_post · scope drafts
Draft/propose a post for one of the brand's connected accounts (see get_capabilities for the live list and what each one can do). Does NOT publish. Saves the exact text as a pending draft in the brand's Inbox — by code, with no agent run and no model credits — and returns its proposalId once the row exists. The network's own limits apply; style notes about the text come back as `notes` and never change it. Only a human can approve it, on the Inbox card in the dashboard; this server has no approve tool. Use withdraw_proposal with the proposalId to cancel it and session_status with the proposalId to see whether it was approved, published or dismissed.
Scope. Save drafts, articles and series proposals to the Inbox, and withdraw your own drafts. Nothing publishes. This endpoint never costs credits.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
text | string | Yes | Exact post text — the network's own limit applies. On article-only networks the first line is the title. |
platform | "x" | "bluesky" | "mastodon" | "pixelfed" | "telegram" | "devdotto" | "discord" | "ghost" | "lemmy" | "nostr" | "tumblr" | "wordpress" | "misskey" | "qiita" | "tabnews" | "youtube" | "dailymotion" | "tiktok" | "hashnode" | "peertube" | "dribbble" | "slack" | "wykop" | "plurk" | "kick" | "twitch" | "hatena" | "line" | No | Platform id from get_capabilities — any registered network |
Request
curl -X POST https://growsocialelion.com/api/v1/propose_post \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"We shipped dark mode today. Settings > Appearance. Tell us what breaks.","platform":"bluesky"}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"reason": "string",
"proposalId": "string",
"published": false
}Errors use the shared body. See Errors. The full schema is in the API reference.