SimplePost docs

SimplePost is one posting stack with five interfaces: MCP, CLI, Scheduler, REST API, and TypeScript SDK. They all wrap the same publishing layer, so start with the workflow that fits your use case and move deeper only when you need more control.

01 / MCPAI agents

Let ChatGPT, Claude, Cursor, and other MCP clients save drafts, validate, publish, or schedule posts through Scheduler-connected accounts.

02 / CLITerminal workflows

Post from a shell, script, CI job, or local coding agent using Scheduler accounts or local CLI accounts.

03 / SchedulerHuman review

Use the hosted or self-hosted web app to connect accounts, compose posts, save drafts, preview, publish, and schedule.

04 / APIBackends and services

Publish over HTTP through either the Scheduler API or the self-hosted REST server.

05 / SDKTypeScript apps

Call the underlying posting layer directly from TypeScript and configure providers yourself.

How the pieces fit

The SDK contains the shared post model, platform adapters, media handling, validation, and credential resolution. The Scheduler, MCP server, CLI, and HTTP API wrap that layer for different environments. The dotted edge from the CLI to Scheduler is the optional account-sharing path: the CLI can post directly through the SDK with local credentials, or borrow accounts a user already connected in Scheduler.

Start by use case

You want to...	Start here	Why
Give an AI assistant posting tools	MCP	The assistant uses OAuth and Scheduler-connected accounts.
Post from a terminal or coding agent	CLI	Works interactively or non-interactively and supports multiple account modes.
Write and schedule posts in a browser	Scheduler	Best for account connection, previews, upload, and human review.
Integrate from another backend or language	API	Stable HTTP contract with Scheduler and self-hosted REST server options.
Build directly in TypeScript	SDK	Lowest abstraction and full provider control.

Common concepts

• Posting model explains the shared payload shape across all interfaces.
• Credential strategies covers environment variables, Scheduler accounts, local CLI storage, and accounts.json.
• Media storage explains public media hosting for platforms that require URLs.
• Platform setup links to credential guides and platform-specific behavior.
• API reference contains the generated OpenAPI reference for Scheduler and the self-hosted server.