Markaestro

Markaestro for AI agents

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.

Connect

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 (Claude Code, Cursor, Codex, Copilot, Gemini, and other agents that read skills; listed on skills.sh):

npx skills add markaestro/markaestro-agents

OpenClaw (listed on ClawHub):

clawhub install markaestro

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

Example prompts

• "What did we post on Instagram last month, and which three posts got the most engagement?"
• "Draft a LinkedIn post announcing our new cold brew and schedule it for Tuesday at 9am New York time. Don't publish anything else."
• "When does our audience respond best? Put next week's three drafts in those slots."

Safety

• The user scopes every connection at sign-in: one brand, or all brands in the workspace. A single-brand connection cannot reach any other brand; an all-brands connection names the brand on each post it creates.
• Agents manage social media, not the account: no tool reaches account settings, billing, team members, API keys, webhooks, or channel connections, and none deletes a published post, takes one down from a platform, or archives an Evergreen queue. The key issued at the agent sign-in carries the same limits at the REST layer, so they hold whichever client holds the token.
• 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.
• Every tool declares readOnlyHint, destructiveHint, and openWorldHint explicitly, set from what it does: destructiveHint on every write except the purely additive ones (create_evergreen_queue, refresh_analytics, upload_media), because the rest edit, remove, unschedule, overwrite a status, or send to a platform now or on a schedule, 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.
• Connected agents are listed and revoked in Markaestro under Settings, API.

Privacy Policy

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.

Support

Email [email protected], 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 [email protected] rather than in a public issue.

License

MIT. Copyright (c) 2026 Aethos Solutions LLC.