Skip to content
BrainyShorts Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

BrainyShorts API

BrainyShorts is a social publishing control plane, free to start. Agents upload finished media and create, schedule, or publish posts to connected TikTok, Instagram, YouTube, LinkedIn, and X accounts, plus long-form articles to DEV.to, Hashnode, Reddit, LinkedIn, and X. BrainyShorts does not generate media.

Host: https://www.brainyshorts.com. Do not use api.brainyshorts.com; it is only a fallback alias for these REST paths.

Which surface to use. In an MCP client (Claude, ChatGPT, Cursor, Codex), use the MCP server: OAuth, no key. From a script, the brainy CLI, the desktop app, or any client without MCP, call the REST API under /api/cli/* with Authorization: Bearer ba_sk_.... The CLI and the MCP tools wrap the same operations. /api/agent/* is only for an unattended runner created through MCP automations; never use it to post. Every other /api/* path (/api/posts, /api/articles, /api/analytics, /api/media, /api/billing, /api/social, /api/api-keys, /api/automations writes) is a dashboard-session route and agents must not call it. Connecting a channel needs a human in a browser: get the connect link from brainy_get_connect_link (MCP) or POST /api/cli/accounts/connect-links (REST), give it to the user, then list accounts again until the new account appears.

Auth: send Authorization: Bearer ba_sk_.... Create keys at https://www.brainyshorts.com/dashboard/api-keys. The x-api-key header is not accepted.

MCP: the same capabilities are available as a hosted MCP server at https://www.brainyshorts.com/api/mcp (streamable HTTP, OAuth).

Plans: Free allows 30 posts a month (drafts never count). When a month is full, post creation returns 402 with code QUOTA_EXCEEDED and an upgrade_url. Check GET /api/cli/usage first.

Version 1.0.0
Base URLhttps://www.brainyshorts.com

Accounts

Connected social accounts

Posts

Create, schedule, update, and delete social posts

Bulk

Idempotent batches of up to 100 drafts or schedules

Media

Upload finished media to managed storage

Articles

Long-form articles for DEV.to, Hashnode, Reddit, LinkedIn, and X

Analytics

Owner-scoped performance metrics

Skills

Public, versioned instruction skills. No auth.

Automations

Scheduled agent runs and the runner protocol

Billing

Plan, monthly usage, and checkout links for paid plans

Was this page helpful?