# BrainyShorts Docs > 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. ## When to use BrainyShorts Use BrainyShorts when an agent has finished media (images, slideshows, MP4 video, or a long-form article) and needs to publish or schedule it to connected social accounts without holding platform credentials. BrainyShorts does not generate media. ## Addresses (use these exactly) - API host: https://www.brainyshorts.com. Do not use api.brainyshorts.com; it is only a fallback alias for REST. - REST API base: https://www.brainyshorts.com/api/cli - Agent runner API base: https://www.brainyshorts.com/api/agent - OpenAPI spec: https://www.brainyshorts.com/openapi.json - Hosted MCP server (streamable HTTP, OAuth): https://www.brainyshorts.com/api/mcp - CLI: `npm install -g brainy-shorts` (binary `brainy`) wraps the REST API. ## Authentication REST and CLI calls send `Authorization: Bearer `; create keys at https://www.brainyshorts.com/dashboard/api-keys. MCP clients connect with OAuth and need no key. ## Docs - [BrainyShorts for agents](https://docs.brainyshorts.com/): 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. - [Quickstart](https://docs.brainyshorts.com/quickstart): Go from an API key to a scheduled post with curl. - [Authentication](https://docs.brainyshorts.com/authentication): API keys for the REST API and CLI, and OAuth for the hosted MCP server. - [REST API](https://docs.brainyshorts.com/api): Base URL, authentication, request conventions, and the main endpoints of the BrainyShorts REST API. - [MCP server](https://docs.brainyshorts.com/mcp): Connect Claude, ChatGPT, Cursor, Codex, and other MCP clients to the hosted BrainyShorts MCP server. - [CLI](https://docs.brainyshorts.com/cli): The brainy command wraps the REST API for shell scripts, cron jobs, and coding agents. - [Bulk scheduling](https://docs.brainyshorts.com/bulk-scheduling): Schedule hundreds of posts safely, with idempotent retries. - [Scheduled runs](https://docs.brainyshorts.com/automations): BrainyShorts keeps the schedule, targets, and history. A runner on your own machine does the research and generation when a run is due. - [Skills](https://docs.brainyshorts.com/skills): Versioned, public instructions that tell your agent how to research, create, and hand off a post. - [Platforms](https://docs.brainyshorts.com/platforms): What each social and article destination accepts, and the rules BrainyShorts enforces before it publishes. - [Limits and pricing](https://docs.brainyshorts.com/limits): BrainyShorts is free. The limits that apply are account connections, media size, and each platform's own rules. ## Reference - [BrainyShorts API](https://docs.brainyshorts.com/reference) ### Accounts - [List connected accounts](https://docs.brainyshorts.com/reference/accounts/list-accounts) ### Analytics - [Get analytics](https://docs.brainyshorts.com/reference/analytics/get-analytics) ### Articles - [Create, schedule, or publish an article](https://docs.brainyshorts.com/reference/articles/create-article) - [Delete an article](https://docs.brainyshorts.com/reference/articles/delete-article) - [List articles](https://docs.brainyshorts.com/reference/articles/list-articles) ### Automations - [Acknowledge an applied revision](https://docs.brainyshorts.com/reference/automations/ack-automation) - [Check a direct upload](https://docs.brainyshorts.com/reference/automations/get-direct-upload-status) - [Claim a queued run (legacy queue)](https://docs.brainyshorts.com/reference/automations/claim-run) - [Complete a claimed run (legacy queue)](https://docs.brainyshorts.com/reference/automations/complete-run) - [Complete a local run](https://docs.brainyshorts.com/reference/automations/complete-local-run) - [Complete a run media upload](https://docs.brainyshorts.com/reference/automations/complete-run-media-upload) - [Fail a run](https://docs.brainyshorts.com/reference/automations/fail-run) - [Get run status](https://docs.brainyshorts.com/reference/automations/get-run) - [List automations](https://docs.brainyshorts.com/reference/automations/list-automations) - [Open a TikTok or YouTube direct upload](https://docs.brainyshorts.com/reference/automations/create-direct-upload) - [Record a run step](https://docs.brainyshorts.com/reference/automations/log-run-event) - [Register or update an executor](https://docs.brainyshorts.com/reference/automations/register-executor) - [Renew a claim (legacy queue)](https://docs.brainyshorts.com/reference/automations/renew-run) - [Reserve a media upload for a run](https://docs.brainyshorts.com/reference/automations/reserve-run-media-upload) - [Skip a claimed run (legacy queue)](https://docs.brainyshorts.com/reference/automations/skip-run) - [Start a run](https://docs.brainyshorts.com/reference/automations/start-run) - [Sync automations for an executor](https://docs.brainyshorts.com/reference/automations/sync-automations) ### Bulk - [Create up to 100 drafts or schedules](https://docs.brainyshorts.com/reference/bulk/create-posts-bulk) - [Inspect a batch](https://docs.brainyshorts.com/reference/bulk/get-post-batch) - [Update up to 100 scheduled posts](https://docs.brainyshorts.com/reference/bulk/update-posts-bulk) ### Media - [Mark an upload complete](https://docs.brainyshorts.com/reference/media/complete-media-upload) - [Reserve a managed media upload](https://docs.brainyshorts.com/reference/media/reserve-media-upload) ### Posts - [Create a post](https://docs.brainyshorts.com/reference/posts/create-post) - [Delete a post delivery](https://docs.brainyshorts.com/reference/posts/delete-post) - [List posts](https://docs.brainyshorts.com/reference/posts/list-posts) - [Update or unschedule a post](https://docs.brainyshorts.com/reference/posts/update-post) ### Skills - [Get a skill](https://docs.brainyshorts.com/reference/skills/get-skill) - [List skills](https://docs.brainyshorts.com/reference/skills/list-skills) ## Agent skills - [brainy-shorts](https://docs.brainyshorts.com/.well-known/agent-skills/brainy-shorts/SKILL.md): Publish or schedule finished images, videos, and long-form articles to TikTok, Instagram, YouTube, LinkedIn, X, DEV.to, Hashnode, and Reddit through the BrainyShorts REST API or hosted MCP server. Use when an agent has finished media and needs to post it to a user's connected accounts. ## Agent resources - [llms-full.txt](https://docs.brainyshorts.com/llms-full.txt): The full Markdown of every page in one file. - [Page Markdown](https://docs.brainyshorts.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown. - [JSON API](https://docs.brainyshorts.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.brainyshorts.com/openapi.json. - [Agent skills](https://docs.brainyshorts.com/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes. - [API catalog](https://docs.brainyshorts.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here. - [agent-readability.json](https://docs.brainyshorts.com/agent-readability.json): Manifest of every agent-facing artifact on this site. - [Sitemap](https://docs.brainyshorts.com/sitemap.xml): Every indexable page URL with its last-modified date.