# BrainyShorts

> Social publishing control plane for AI agents, free to start. Connect TikTok, Instagram, YouTube, LinkedIn, X, and article destinations once, then let agents upload finished media and schedule posts through a REST API, a CLI, or a hosted MCP server. BrainyShorts does not generate media; your agent or runner does.

## Addresses (use these exactly)

- Site and API host: https://www.brainyshorts.com (use www; api.brainyshorts.com is only a fallback alias)
- REST API base: https://www.brainyshorts.com/api/cli (posts, accounts, uploads, analytics, articles)
- Agent runner API base: https://www.brainyshorts.com/api/agent (automations, runs, executors)
- OpenAPI 3.1 spec: https://www.brainyshorts.com/openapi.json
- Hosted MCP server (streamable HTTP, OAuth 2.1 + PKCE): https://www.brainyshorts.com/api/mcp
- MCP discovery: https://www.brainyshorts.com/.well-known/mcp.json
- API catalog (RFC 9727): https://www.brainyshorts.com/.well-known/api-catalog
- CLI: `npm install -g brainy-shorts`, binary `brainy`

## Authentication

- REST and CLI: create an API key at https://www.brainyshorts.com/dashboard/api-keys, then send `Authorization: Bearer <key>`. The `x-api-key` header is not accepted.
- CLI: `brainy config --api-key <key>` or set `BRAINY_API_KEY`. Override the host with `BRAINY_API_URL` (defaults to the site above).
- MCP: add https://www.brainyshorts.com/api/mcp as a remote MCP server; the client runs the OAuth flow advertised at https://www.brainyshorts.com/.well-known/oauth-authorization-server. No API key is needed.

## When to use BrainyShorts

Use it 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. List accounts first, upload media, then create posts with a `scheduled_time` or publish immediately.

## Limits

- Free plan: 5 social accounts and 30 posts a month (drafts never count; a post counts once, however many accounts it targets). Creator ($15/month): unlimited posts. Pro ($49/month): 15 accounts and unlimited posts.
- Check remaining allowance with `GET https://www.brainyshorts.com/api/cli/usage`. When a create or schedule call would exceed the monthly allowance it returns 402 with code `QUOTA_EXCEEDED` and `upgrade_url`; save as a draft or schedule for a later month instead.
- An agent can get a Stripe Checkout link for its user with `POST https://www.brainyshorts.com/api/cli/billing/checkout` and body `{"plan":"creator"}` or `{"plan":"pro"}`. Give the link to the user to open and pay.
- Managed images up to 15 MiB; managed MP4 up to 200 MiB. LinkedIn and X video up to 32 MB.
- TikTok photo posts: up to 12 images; titles are truncated to 80 characters and hashtags are stripped.

## Docs

- [Documentation home](https://docs.brainyshorts.com): Overview, quickstart, and concepts
- [Quickstart](https://docs.brainyshorts.com/quickstart): API key to first scheduled post
- [REST API](https://docs.brainyshorts.com/api): Endpoints, auth, errors, and examples
- [CLI](https://docs.brainyshorts.com/cli): Install and command reference
- [MCP server](https://docs.brainyshorts.com/mcp): Connect Claude, Cursor, ChatGPT, and other MCP clients
- [Full docs corpus](https://docs.brainyshorts.com/llms-full.txt): Every docs page as Markdown in one file