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.
MCP server
Best for Claude, Cursor, ChatGPT, and other MCP clients. OAuth sign-in, no key to paste.
REST API
Plain HTTPS with a Bearer key. Works from any language or agent framework.
CLI
brainy wraps the REST API for shell scripts and coding agents.
Scheduled runs
BrainyShorts schedules the work and your own runner does it.
For agents reading this
- Machine-readable index:
/llms.txt, full corpus:/llms-full.txt. - The same addresses are served from the app itself at
https://www.brainyshorts.com/llms.txt,/.well-known/mcp.json, and/.well-known/api-catalog. - An installable agent skill is published at
/.well-known/agent-skills/index.json.
