The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Markaestro listing page.
Official agent tooling for Markaestro, the social publishing workspace. Agents schedule, publish, and review posts on Facebook, Instagram, TikTok, Threads, Pinterest, LinkedIn, and X, read brand and per-post analytics, and manage Intelligent Evergreen queues.
| Folder | What it is |
|---|---|
plugin/ | Claude Code plugin: the skill plus the hosted MCP server |
skills/markaestro/ | The markaestro Agent Skill, usable by any client that supports skills |
mcp/ | @markaestro/mcp, the MCP server as a local stdio package |
The hosted MCP server needs nothing installed and no key pasted. Add
https://markaestro.com/api/public/v1/mcp to your client; the first tool
call opens the browser to sign in, pick a workspace and brand, and click
Allow (OAuth 2.1 with PKCE and dynamic client registration).
Claude Code
Claude (claude.ai and Claude Desktop): open Customize, Connectors, click
Add custom connector, paste https://markaestro.com/api/public/v1/mcp, leave
the OAuth client fields empty, and click Add. Click Connect to sign in.
Cursor, ChatGPT, Grok, OpenClaw, Hermes, and other clients: step by step instructions for each are at markaestro.com/developers/agents.
Skill only (Claude Code, Cursor, Codex, Copilot, Gemini, and other agents that read skills; listed on skills.sh):
OpenClaw (listed on ClawHub):
Local package (reads media from your own disk; needs a workspace API key from Settings, API Access):
create_post saves a draft unless scheduledAt is set. publish_post is
the only tool that publishes immediately; scheduling (scheduledAt,
bulk_posts, activating an Evergreen queue) sets up future publishes. The
skill tells the agent to ask the user before publish_post and before
activating an Evergreen queue.readOnlyHint, destructiveHint, and openWorldHint
explicitly, set from what it does: destructiveHint on tools that edit,
remove, unschedule, or publish (update_post, delete_post, bulk_posts,
publish_post, update_evergreen_queue, pause_evergreen_queue), and
openWorldHint on tools that can change what appears on a platform, now or
on a schedule. Clients that honor annotations, Claude among them, ask for
confirmation before writes.Markaestro processes the posts, media, and analytics the agent reads or writes for the brands the connection covers, and nothing from the conversation beyond each tool call's arguments. Section 7 of the Privacy Policy, "AI agents and connected apps", covers agent connections specifically; the policy as a whole explains what is collected, how it is used and retained, who it is shared with, and how to contact us. Terms of Service.
Email support@markaestro.com, use the
contact page, or open an issue in this
repository. If a sign-in or tool call fails, include the requestId from the
error; it lets support trace the call. Report security vulnerabilities
privately to support@markaestro.com rather than in a public issue.
MIT. Copyright (c) 2026 Aethos Solutions LLC.