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

BrainyShorts for agents

Publish and schedule agent-made media to TikTok, Instagram, YouTube, LinkedIn, X, and article platforms through a REST API, a CLI, or a hosted MCP server.

BrainyShorts is a publishing control plane that is free to start. You connect your social accounts once in the dashboard. After that, an agent can upload finished media and publish or schedule posts without ever holding a platform token.

BrainyShorts does not generate media. Your agent, your runner, or your own tooling makes the images, video, or article; BrainyShorts stores it, schedules it, and hands it to each platform.

Addresses

Everything lives on one host, www.brainyshorts.com. Don’t configure api.brainyshorts.com: it only exists as a fallback for REST calls and doesn’t serve MCP or OAuth.

What Address
REST API https://www.brainyshorts.com/api/cli
Agent runner API https://www.brainyshorts.com/api/agent
OpenAPI spec https://www.brainyshorts.com/openapi.json
Hosted MCP server https://www.brainyshorts.com/api/mcp
CLI npm install -g brainy-shorts (binary brainy)
API keys https://www.brainyshorts.com/dashboard/api-keys

Pick an interface

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.

For agents reading this

Was this page helpful?