# Markaestro > Markaestro is a social media publishing platform for people who market more > than one brand: products, businesses, clients, or themselves. Connect > Facebook, Instagram, TikTok, LinkedIn, Threads, Pinterest, X, and YouTube > once, then schedule, publish, and measure posts for every brand from one calendar, or > let an AI agent drive it over MCP or the API. ## Product Summary - Who it is for: solo marketers, small teams, and agencies running several brands; developers and AI agents automating social publishing. - Channels (8): Facebook, Instagram, TikTok, LinkedIn, Threads, Pinterest, X, YouTube (videos and Shorts). - Publishing: one composer for every channel, a content calendar, scheduling, per-channel previews, and validation of each platform's caption and media limits before a post goes out. Write a shared caption with per-channel overrides, insert saved brand snippets, import CSV rows as drafts, or start a new draft from a published post. Personal calendar views save filters and layout. On Pro and Business, users with link-tracking access can track a URL directly in the caption. Media library per workspace. - Multi-brand: a workspace holds several brands, each with its own channels, brand voice, and brand identity (logo and colors). Six roles govern workspace access. Clients see submitted posts for assigned brands. Creators can submit for single review or internal review followed by client sign-off. Owners, Admins and Managers / Publishers publish their own posts directly. Owners and Admins can view and export the workspace audit log. - Analytics: post and follower metrics pulled back from every channel, unlimited history, CSV export. - Intelligence: ranks what performed, explains why, finds each brand's best posting windows, and drafts caption suggestions grounded only in the brand's own measured results and profile. It does not generate images or video; you bring the media. - Intelligent Evergreen: recurring queues that republish past posts you choose. You can rank past posts by any recorded metric to find candidates, every source post needs an owner review before a queue runs, and captions rotate on a fixed or learned schedule. It never picks or activates a queue on its own. - For agents and developers: hosted MCP server with OAuth sign-in (no key paste), a REST API, and signed webhooks on every plan. - Pricing: one plan per workspace, no per-seat charge inside plan limits. Starter $19/mo, Growth $29.99/mo, Pro $59/mo, Business $149/mo (lower when billed annually). Every plan starts with a 7-day free trial; a card is required and there is no permanent free plan. Full machine-readable pricing: https://markaestro.com/pricing.md Human docs: https://markaestro.com/developers/api Agent guide: https://markaestro.com/developers/agents ## For AI agents Base URL: https://markaestro.com Auth: `Authorization: Bearer mk_live_..` Keys are created by a workspace admin at /settings?tab=api and cover either ONE brand or ALL brands in the workspace. A single-brand key cannot reach another brand and never needs a brand/product id. An all-brands key names the brand per request: `productId` on POST /posts, GET /posts, POST /evergreen-queues, and (to report on one brand instead of the workspace) the analytics endpoints. GET /products lists the brands a key can act on. MCP clients need no key at all. Add the hosted server `https://markaestro.com/api/public/v1/mcp` with no credentials: it answers 401 with a WWW-Authenticate challenge, the client discovers the OAuth server at /.well-known/oauth-authorization-server, registers itself, and opens the browser on /oauth/authorize where the user picks a workspace and one brand or All brands. The access token the client receives IS a workspace API key with that brand scope (30 days, rotated on refresh). If tools are missing or return UNAUTHENTICATED, tell the user to sign in from their client; never ask the user to paste a key. Per-client setup (each link opens that client's tab on the agents page): - Claude Code: `claude plugin marketplace add markaestro/markaestro-agents` then `claude plugin install markaestro@markaestro`; sign in with `/mcp`. https://markaestro.com/developers/agents?client=claude-code - Claude (claude.ai, Desktop): Settings, Connectors, Add custom connector, paste the server URL. https://markaestro.com/developers/agents?client=claude - Cursor: one-click deeplink on the page, or `{"mcpServers":{"markaestro": {"url":"https://markaestro.com/api/public/v1/mcp"}}}` in .cursor/mcp.json; sign in from Tools & MCP. https://markaestro.com/developers/agents?client=cursor - ChatGPT: Developer mode, Apps & Connectors, Create, server URL, OAuth, Scan Tools. https://markaestro.com/developers/agents?client=chatgpt - Grok: grok.com/connectors (Custom; client id markaestro-grok-web if asked), `grok mcp add --transport http markaestro ` in Grok Build, or a `{"type":"mcp","server_url":...,"authorization":"Bearer mk_..."}` tool in the xAI API. https://markaestro.com/developers/agents?client=grok - Grok Bot: in chat, "Add a custom MCP server called Markaestro at ", then Authorize on the connect card (a workspace API key as a header also works). https://markaestro.com/developers/agents?client=grok-bot - OpenClaw: `openclaw mcp add markaestro --url --transport streamable-http --auth oauth`, then `openclaw mcp login markaestro`. https://markaestro.com/developers/agents?client=openclaw - Hermes: `mcp_servers.markaestro: { url, auth: oauth }` in ~/.hermes/config.yaml, then /reload-mcp. https://markaestro.com/developers/agents?client=hermes - No browser (CI, cron): `Authorization: Bearer mk_...` header on the same server. https://markaestro.com/developers/agents?client=headless Two surfaces over the same pipeline: - `/api/connect/v1` — flat, snake_case, fewest calls. Start here. - `/api/public/v1` — full control: explicit publish, async runs, webhooks, batch create, per-channel settings. ### Connect API (recommended) GET /api/connect/v1/social-accounts → { data: [ { id, product_id, product, platform, username } ] } `id` is opaque — pass it back verbatim in `social_accounts`. GET /api/connect/v1/products → brands with their accounts nested POST /api/connect/v1/media/create-upload-url { mime_type, size_bytes, name } → { media_id, upload_url } PUT the raw bytes to upload_url with the right Content-Type. Single-use, expires in 15 minutes, needs no Authorization header. POST /api/connect/v1/posts { caption, media: [media_id], social_accounts: [id], scheduled_at, is_draft } Draft-first. Send is_draft=false WITH scheduled_at to schedule. Fans out one post per account id. → { id, created[], errors[] } GET /api/connect/v1/posts?limit= → status is one of draft | processing | posted | failed ### Public API v1 (full control) GET /api/public/v1/products GET /api/public/v1/products/:id/destinations POST /api/public/v1/media (multipart, field: file) POST /api/public/v1/posts (create — always a DRAFT) POST /api/public/v1/posts ({ posts: [...] } = batch, 1–25) GET /api/public/v1/posts?status=&limit= (limit max 100) GET /api/public/v1/posts/:id PATCH /api/public/v1/posts/:id (edit a draft or scheduled post) DELETE /api/public/v1/posts/:id POST /api/public/v1/posts/:id/publish → 202 { run: { id, status } } POST /api/public/v1/posts/:id/mark-posted (a person posted it natively) GET /api/public/v1/products/:id/profile (brand voice and identity) GET /api/public/v1/tiktok/creator-info (TikTok Direct Post options) GET /api/public/v1/analytics (?productId= for one brand) POST /api/public/v1/analytics/refresh (pull live metrics now) GET /api/public/v1/analytics/best-times (learned posting windows) GET /api/public/v1/job-runs/:id → queued|running|succeeded|failed POST /api/public/v1/webhook-endpoints GET /api/public/v1/webhook-endpoints DELETE /api/public/v1/webhook-endpoints/:id Create body: `{ channel, caption, mediaAssetIds[], destinationId?, deliveryMode?, settings? }`. `channel` is one of facebook, instagram, tiktok, threads, pinterest, linkedin, x, youtube. Omit scheduledAt to create a draft. Scheduling and publishing respect workspace approval requirements. Post status: draft | scheduled | publishing | published | platform_action_required | failed | partial_failed Scopes: products.read, media.write, posts.read, posts.write, posts.publish, posts.approve, evergreen.read, evergreen.write, analytics.read, job_runs.read, webhooks.manage ### Rules that matter 1. Discover before you post. Call `/social-accounts` at the start of a run and pass ids back verbatim. Never hardcode or cache an account id across runs. 2. Upload media first — posts reference media ids, not files. Images: png, jpeg, webp, gif up to 10 MB. Video: mp4, mov, webm up to 250 MB. 3. In full v1, Facebook, Instagram and TikTok default to a manual reminder. For API delivery, request direct_publish. TikTok uses the creator inbox by default, with Direct Post available for eligible connections using settings.postMode=direct_post. Connect selects API delivery for its chosen accounts, including the TikTok inbox handoff. On either surface, the workspace approval policy still applies to the acting user. 4. Send `Idempotency-Key` on every POST. Reuse the SAME key when retrying the SAME request; a different body under the same key is rejected. Replays are honored for 24 hours. 5. Publishing is async. `POST /publish` returns a run id — poll `/job-runs/:id`, or register a webhook. Never report a post as live until a run says `succeeded` or the post says `published`. 6. Rate limits: 60 req/min per endpoint, 240 req/min per key. Read `X-RateLimit-Remaining`; on 429 sleep for `Retry-After` seconds, then retry. 7. Deleting a scheduled post cancels it. Deleting a PUBLISHED post only stops Markaestro tracking it — the live platform copy stays up. ### Errors Every error is JSON: `{ "error": "CODE", "requestId": "..." }`. Quote the requestId when reporting a failure. 401 UNAUTHENTICATED key missing/revoked/expired — stop, ask a human 403 FORBIDDEN key lacks the scope — stop 403 API_KEY_NOT_BOUND_TO_PRODUCT legacy key — ask for a replacement 400 VALIDATION_* bad payload — fix it, do not retry unchanged 400 VALIDATION_IDEMPOTENCY_KEY_REUSED same key, different body — mint a new one 400 VALIDATION_POST_IS_PUBLISHING delete blocked by an in-flight run — wait 402 QUOTA_EXCEEDED_MEDIA_UPLOADS monthly upload quota hit — stop uploading 404 NOT_FOUND id is outside this key's brand 409 VALIDATION_POST_ALREADY_PUBLISHING a run is already queued — poll it 429 RATE_LIMITED back off for Retry-After seconds ### Webhooks Events: post.publish.queued, post.published, post.action_required, post.failed Headers: X-Markaestro-Event, X-Markaestro-Timestamp, X-Markaestro-Signature (HMAC of the body with the webhook secret, shown once at creation). Verify the signature before acting on a delivery. ## Pages - https://markaestro.com/ — overview - https://markaestro.com/features — what the platform does - https://markaestro.com/channels — per-channel capabilities and limits - https://markaestro.com/pricing — plans; API access is included on all of them - https://markaestro.com/pricing.md — the same plans as plain markdown - https://markaestro.com/developers/api — full API reference - https://markaestro.com/developers/agents — AI agent guide, per-client connect steps, tool schemas - https://markaestro.com/terms — terms of service - https://markaestro.com/privacy — privacy policy - https://markaestro.com/contact — support and sales ## Guides and Reference - https://markaestro.com/channels/instagram, /channels/facebook, /channels/tiktok, /channels/linkedin, /channels/threads, /channels/pinterest, /channels/x, /channels/youtube: what can be scheduled on each network, the limits checked, and the metrics returned - https://markaestro.com/features/multi-brand, /features/scheduling, /features/analytics, /features/intelligence, /features/evergreen, /features/media-library, /features/brand-profile, /features/team - https://markaestro.com/specs: image sizes, video limits, and caption lengths per network, sourced from each platform's documentation - https://markaestro.com/tools: free character counter, UTM builder, and image size finder - https://markaestro.com/compare and /alternatives: Markaestro compared with Buffer, Hootsuite, Later, Sprout Social, SocialBee, Metricool, Postiz, RecurPost, Vista Social, Planable, SocialPilot, and Blotato, with dated sources - https://markaestro.com/for: agencies, freelancers, small businesses, ecommerce, and app developers - https://markaestro.com/glossary, /blog, /changelog ## Key pages ### Product - [Features](https://markaestro.com/features) - [Channels](https://markaestro.com/channels) - [Pricing](https://markaestro.com/pricing) - [Instagram](https://markaestro.com/channels/instagram) - [Facebook](https://markaestro.com/channels/facebook) - [TikTok](https://markaestro.com/channels/tiktok) - [LinkedIn](https://markaestro.com/channels/linkedin) - [Threads](https://markaestro.com/channels/threads) - [Pinterest](https://markaestro.com/channels/pinterest) - [X](https://markaestro.com/channels/x) - [YouTube](https://markaestro.com/channels/youtube) - [Multi brand](https://markaestro.com/features/multi-brand) - [Scheduling](https://markaestro.com/features/scheduling) - [Analytics](https://markaestro.com/features/analytics) - [Intelligence](https://markaestro.com/features/intelligence) - [Evergreen](https://markaestro.com/features/evergreen) - [Media library](https://markaestro.com/features/media-library) - [Brand profile](https://markaestro.com/features/brand-profile) - [Team roles and client approvals](https://markaestro.com/features/team) - [Set up client sign-off](https://markaestro.com/blog/social-media-approval-workflow-for-agencies) - [Run a social media A/B experiment](https://markaestro.com/blog/test-social-media-posts-with-ab-experiments) - [Import a content calendar from CSV](https://markaestro.com/blog/import-social-media-content-calendar-csv) - [Specs](https://markaestro.com/specs) - [Instagram](https://markaestro.com/specs/instagram) - [Facebook](https://markaestro.com/specs/facebook) - [TikTok](https://markaestro.com/specs/tiktok) - [LinkedIn](https://markaestro.com/specs/linkedin) - [Threads](https://markaestro.com/specs/threads) - [Pinterest](https://markaestro.com/specs/pinterest) - [X](https://markaestro.com/specs/x) - [YouTube](https://markaestro.com/specs/youtube) - [For](https://markaestro.com/for) - [Agencies](https://markaestro.com/for/agencies) - [Freelancers](https://markaestro.com/for/freelancers) - [Small businesses](https://markaestro.com/for/small-businesses) - [Ecommerce](https://markaestro.com/for/ecommerce) - [App developers](https://markaestro.com/for/app-developers) ### Comparisons - [Compare](https://markaestro.com/compare) - [Markaestro vs Buffer](https://markaestro.com/compare/markaestro-vs-buffer) - [Markaestro vs Hootsuite](https://markaestro.com/compare/markaestro-vs-hootsuite) - [Markaestro vs Later](https://markaestro.com/compare/markaestro-vs-later) - [Markaestro vs Sprout Social](https://markaestro.com/compare/markaestro-vs-sprout-social) - [Markaestro vs SocialBee](https://markaestro.com/compare/markaestro-vs-socialbee) - [Markaestro vs Metricool](https://markaestro.com/compare/markaestro-vs-metricool) - [Markaestro vs Postiz](https://markaestro.com/compare/markaestro-vs-postiz) - [Markaestro vs recurpost](https://markaestro.com/compare/markaestro-vs-recurpost) - [Markaestro vs Vista Social](https://markaestro.com/compare/markaestro-vs-vista-social) - [Markaestro vs Planable](https://markaestro.com/compare/markaestro-vs-planable) - [Markaestro vs socialpilot](https://markaestro.com/compare/markaestro-vs-socialpilot) - [Markaestro vs Blotato](https://markaestro.com/compare/markaestro-vs-blotato) - [Alternatives](https://markaestro.com/alternatives) - [Buffer](https://markaestro.com/alternatives/buffer) - [Hootsuite](https://markaestro.com/alternatives/hootsuite) - [Later](https://markaestro.com/alternatives/later) - [Sprout Social](https://markaestro.com/alternatives/sprout-social) - [SocialBee](https://markaestro.com/alternatives/socialbee) - [Metricool](https://markaestro.com/alternatives/metricool) - [Postiz](https://markaestro.com/alternatives/postiz) - [Recurpost](https://markaestro.com/alternatives/recurpost) - [Vista Social](https://markaestro.com/alternatives/vista-social) - [Planable](https://markaestro.com/alternatives/planable) - [Socialpilot](https://markaestro.com/alternatives/socialpilot) - [Blotato](https://markaestro.com/alternatives/blotato) ### Guides and glossary - [Tools](https://markaestro.com/tools) - [Character counter](https://markaestro.com/tools/character-counter) - [UTM builder](https://markaestro.com/tools/utm-builder) - [Image size finder](https://markaestro.com/tools/image-size-finder) - [Glossary](https://markaestro.com/glossary) - [Evergreen content](https://markaestro.com/glossary/evergreen-content) - [Content recycling](https://markaestro.com/glossary/content-recycling) - [Engagement rate](https://markaestro.com/glossary/engagement-rate) - [Reach vs impressions](https://markaestro.com/glossary/reach-vs-impressions) - [Content calendar](https://markaestro.com/glossary/content-calendar) - [Content pillars](https://markaestro.com/glossary/content-pillars) - [Best time to post](https://markaestro.com/glossary/best-time-to-post) - [UTM parameters](https://markaestro.com/glossary/utm-parameters) - [Click through rate](https://markaestro.com/glossary/click-through-rate) - [Carousel post](https://markaestro.com/glossary/carousel-post) - [Aspect ratio](https://markaestro.com/glossary/aspect-ratio) - [Social media scheduling](https://markaestro.com/glossary/social-media-scheduling) - [Cross posting](https://markaestro.com/glossary/cross-posting) - [Brand voice](https://markaestro.com/glossary/brand-voice) - [Social media analytics](https://markaestro.com/glossary/social-media-analytics) - [Ab testing](https://markaestro.com/glossary/ab-testing) - [MCP](https://markaestro.com/glossary/mcp) - [Social media API](https://markaestro.com/glossary/social-media-api) - [Social listening](https://markaestro.com/glossary/social-listening) - [Hashtag](https://markaestro.com/glossary/hashtag) - [Blog](https://markaestro.com/blog) - [Manage social media for multiple brands](https://markaestro.com/blog/manage-social-media-for-multiple-brands) - [Let claude or chatgpt post to social media](https://markaestro.com/blog/let-claude-or-chatgpt-post-to-social-media) - [Reuse evergreen content on social media](https://markaestro.com/blog/reuse-evergreen-content-on-social-media) - [Find your best time to post](https://markaestro.com/blog/find-your-best-time-to-post) - [Social media report for clients](https://markaestro.com/blog/social-media-report-for-clients) - [TikTok inbox vs direct post](https://markaestro.com/blog/tiktok-inbox-vs-direct-post) ### Developers - [Agents](https://markaestro.com/developers/agents) - [API](https://markaestro.com/developers/api)