Schedule, publish, and review social posts and analytics for a Markaestro brand.
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 plugin marketplace add markaestro/markaestro-agents
claude plugin install markaestro@markaestro
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
npx skills add markaestro/markaestro-agents
Local package (reads media from your own disk; needs a workspace API key from Settings, API Access):
claude mcp add markaestro -e MARKAESTRO_API_KEY=mk_live_... -- npx -y @markaestro/mcp
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.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @markaestro/mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"com-markaestro-mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceMarkaestro works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.