# Markaestro

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: markaestro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markaestro/markaestro-agents/tree/HEAD/mcp
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/markaestro

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://markaestro.com/api/public/v1/mcp`
- Environment variables: `MARKAESTRO_API_KEY`, `MARKAESTRO_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://markaestro.com/api/public/v1/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> --env MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> --transport stdio mcp -- npx -y @markaestro/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://markaestro.com/api/public/v1/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp --env MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> --env MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> -- npx -y @markaestro/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://markaestro.com/api/public/v1/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://markaestro.com/api/public/v1/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://markaestro.com/api/public/v1/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e MARKAESTRO_API_KEY=<MARKAESTRO_API_KEY> -e MARKAESTRO_READ_ONLY=<MARKAESTRO_READ_ONLY> mcp npx -y @markaestro/mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 397855
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 34011
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89674
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81191
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74577
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 90077

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md