Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
posts_createTOOL
Create a social media post as a draft, publish it immediately, or schedule it for later.
Three modes:
  • No timing flag: publishes immediately to all selected platforms
  • --draft: saves a draft (stored by Akarso, publish later with drafts publish)
  • --scheduled-at: schedules for a future time (accepts ISO dates like 2026-03-15T14:00:00Z, or relative values: 30m, 2h, 3d, 1w)
The same text and media are applied to every selected platform. Platforms are specified as a comma-separated list (e.g. --platforms x,linkedin,instagram). Run accounts list to see which platforms are connected in the current profile.
Media: attach images or videos with --media. Accepts local file paths and https URLs, comma-separated. URLs are referenced directly; local files are uploaded first. Supported formats: jpg, png, webp, gif, mp4, mov.
Pinterest: requires --pinterest-board <boardId>. List board IDs with accounts pinterest-boards.
Publishing requires an active subscription. Returns 402 if no subscription exists (run akarso subscribe to start a free trial) and 403 if the org has hit its plan's monthly post limit or account limit. Drafts are free.
Parameters
text *string
Post text content, applied to every platform
platforms *string
Comma-separated platforms to publish to (x, twitter, instagram, facebook, linkedin, tiktok, youtube, threads, pinterest, bluesky, googlebusiness)
draft?boolean
Save as a draft instead of publishing
scheduledAt?string
Schedule time: ISO date, 30m, 2h, 3d, or 1w
media?string
Comma-separated media items: local file paths or https URLs. URLs are referenced directly; local files are uploaded (not available on the hosted MCP server, use URLs there).
pinterestBoard?string
Pinterest board ID to pin to (required when posting to pinterest)
Request example
{
  "method": "tools/call",
  "params": {
    "name": "posts_create",
    "arguments": {
      "text": "string",
      "platforms": "string",
      "draft": true,
      "scheduledAt": "string",
      "media": "string",
      "pinterestBoard": "string"
    }
  }
}
Powered byHolocron