Markaestro — Claude Code MCP server for social posts
Connect an agent to Markaestro to draft, schedule and review brand posts and analytics. Useful when you want to handle social publishing through an MCP client.
claude mcp add --transport http mcp https://markaestro.com/api/public/v1/mcpWhat Markaestro does
Markaestro gives an MCP client tools for managing a brand’s posts and performance data. An agent can inspect posts and destinations, save drafts, schedule or edit posts, upload media, and check analytics for a brand or individual posts. Evergreen tools handle recurring content queues.
Choose the hosted HTTP server, which authorizes through a browser, or run the local @markaestro/mcp package over stdio. The local setup needs a Markaestro API key in MARKAESTRO_API_KEY. A post created without scheduledAt stays a draft; publish_post is the tool for immediate publishing, and the agent is instructed to ask the user first.
The server does not expose account settings, billing, team management, API keys, webhooks, or channel connections. It also refuses to delete published posts. Those limits matter if your workflow expects the agent to manage the whole account: those controls remain in Markaestro.
What it helps with
- save a post draft or schedule it for a brand
- revise the copy or timing of a scheduled post
- review brand performance and post-level metrics
- upload media and retrieve its asset ID
- find posting windows based on a brand’s history
Example prompts for the agent
- Draft a post for this brand and show it to me before publishing.
- Schedule this post for the requested time and check the channel rules.
- Review this brand’s post analytics for the selected period.
How to install Markaestro
1Platform CLI: remote server
claude mcp add --transport http mcp https://markaestro.com/api/public/v1/mcp2Platform CLI
claude mcp add --env MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> --env MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> --transport stdio mcp -- npx -y @markaestro/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcp --url https://markaestro.com/api/public/v1/mcp2Platform CLI
codex mcp add mcp --env MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> --env MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> -- npx -y @markaestro/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"url": "https://markaestro.com/api/public/v1/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<MARKAESTRO_API_KEY>",
"MARKAESTRO_READ_ONLY": "<MARKAESTRO_READ_ONLY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://markaestro.com/api/public/v1/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<MARKAESTRO_API_KEY>",
"MARKAESTRO_READ_ONLY": "<MARKAESTRO_READ_ONLY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp https://markaestro.com/api/public/v1/mcp2Platform CLI
gemini mcp add -e MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> -e MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> mcp npx -y @markaestro/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Markaestro
How do I install Markaestro in Claude Code?
For the hosted connection, run claude mcp add --transport http mcp https://markaestro.com/api/public/v1/mcp. For a local server, run `claude mcp add --env MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> --env MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> --transport stdio mcp -- npx -y @markaestro/mcp`.
What does Markaestro do?
It connects an MCP client to Markaestro tools for social posts and brand analytics. Agents can draft, schedule, edit and review posts, as well as upload media.
Can the agent publish a post immediately?
Creating a post without scheduledAt saves a draft. Immediate publishing uses publish_post, and the agent is instructed to get user confirmation first.
