Markaestro API를 통해 AI agent가 소셜 미디어 게시물을 예약, 발행 및 검토하고 브랜드 분석을 수행할 수 있습니다.
다른 이름 markaestro/markaestro-agents, mcp, @markaestro/mcp
- 스타
- 0
- Tools
- 18
- 다운로드, 30일
- —
- 최신 버전
- 0.5.0
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
Markaestro MCP란?
Markaestro API를 통해 AI agent가 소셜 미디어 게시물을 예약, 발행 및 검토하고 브랜드 분석을 수행할 수 있습니다. 18개 도구를 제공합니다. 예: list_products, list_destinations, get_brand_profile.
프로젝트 README에서 생성된 요약
Markaestro MCP server 정보
Markaestro는 AI agent가 단일 인터페이스를 통해 소셜 미디어 워크플로우를 관리할 수 있도록 지원하는 MCP server를 제공합니다. 개발자는 Claude, Cursor 또는 ChatGPT와 같은 클라이언트를 연결하여 브랜드 콘텐츠를 예약, 발행 및 검토할 수 있습니다. 이 서버는 OAuth 2.1을 사용하는 HTTP 기반의 호스팅 연결과 stdio를 통한 로컬 설치를 모두 지원합니다. 로컬 설정에서는 upload_media 도구가 머신의 파일에 직접 접근할 수 있으며, 호스팅 버전은 별도의 설치 없이 브라우저 기반 로그인 프로세스를 사용합니다.
사용자는 API key 권한에 따라 단일 브랜드 또는 워크스페이스 전체의 콘텐츠를 관리할 수 있습니다. 도구 세트에는 단일 또는 대량 게시물 생성, 미디어 자산 관리, 상세 분석을 통한 성과 모니터링 기능이 포함됩니다. 또한 반복되는 콘텐츠를 처리하기 위한 evergreen 도구도 제공합니다. 안전성을 보장하기 위해 서버는 초안 작성 후 발행하는 방식을 따르며, 발행을 위해서는 명시적인 명령이 필요합니다. 또한 agent는 결제 정보, 팀 설정 수정 또는 이미 발행된 게시물 삭제 작업이 제한됩니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Markaestro MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Markaestro MCP 설치
$ claude mcp add --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp -- npx -y @markaestro/mcpCursor에 Markaestro MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}VS Code에 Markaestro MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}VS Code CLI에 Markaestro MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@markaestro/mcp"],"env":{"MARKAESTRO_API_KEY":"<YOUR_MARKAESTRO_API_KEY>"}}'Claude Desktop에 Markaestro MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Codex에 Markaestro MCP 설치
$ codex mcp add mcp --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' -- npx -y @markaestro/mcpCodex config.toml에 Markaestro MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@markaestro/mcp"] [mcp_servers.mcp.env] MARKAESTRO_API_KEY = "<YOUR_MARKAESTRO_API_KEY>"
Gemini CLI에 Markaestro MCP 설치
$ gemini mcp add -s user -e 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp npx -- -y @markaestro/mcpGemini settings.json에 Markaestro MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Markaestro MCP 도구 18
README에서 감지됨list_productslist_destinationsget_brand_profilecreate_postupdate_postpublish_postmark_post_posteddelete_postbulk_postscreate_postsupload_mediaget_analytics
| list_products | — | |
| list_destinations | — | |
| get_brand_profile | — | |
| create_post | — | |
| update_post | — | |
| publish_post | — | |
| mark_post_posted | — | |
| delete_post | — | |
| bulk_posts | — | |
| create_posts | — | |
| upload_media | — | |
| get_analytics | — |
도구 18개 모두 보기도구 수 줄이기
list_post_analyticsget_post_analytics_historyrefresh_analyticssuggest_post_timesget_channel_rulesget_tiktok_posting_options
| list_post_analytics | — | |
| get_post_analytics_history | — | |
| refresh_analytics | — | |
| suggest_post_times | — | |
| get_channel_rules | — | |
| get_tiktok_posting_options | — |
구성
MARKAESTRO_API_KEY필수비밀Workspace API key (mk_live_ or mk_test_) from Settings, API Access. Covers one brand or all brands in the workspace.
MARKAESTRO_READ_ONLYSet to 1 to register only the reading tools.
| 이름 | 설명 | 유형 |
|---|---|---|
| MARKAESTRO_API_KEY | Workspace API key (mk_live_ or mk_test_) from Settings, API Access. Covers one brand or all brands in the workspace. | 필수비밀 |
| MARKAESTRO_READ_ONLY | Set to 1 to register only the reading tools. |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기@markaestro/mcp
A Model Context Protocol server that lets AI
agents (Claude Code, Claude, Cursor, ChatGPT, Grok, Grok Bot, OpenClaw, Hermes,
and any other MCP client) schedule, publish, and review Markaestro posts
through the public API. Exact connection steps per client are on
https://markaestro.com/developers/agents (?client=cursor, chatgpt, grok,
grok-bot, openclaw, hermes, or headless opens that tab).
Every key covers either one brand or every brand in its workspace, chosen
when the key is created or at the sign-in consent. A single-brand key works on
that brand alone. An all-brands key sees every brand: list_products returns
them all, and the agent passes productId to create_post, create_posts,
list_posts, and create_evergreen_queue, and to the analytics tools to
report on one brand instead of the whole workspace.
Tools
| Tool | What it does |
|---|---|
list_products |
The brands this key can act on (one, or all in the workspace) and their connected channels |
list_destinations |
Publishable destinations of the brand (pages, accounts) with ids |
get_brand_profile |
A brand's description, voice, and visual identity (read-only) |
list_posts, get_post |
Read posts by status, page through with cursor |
create_post |
Save a draft, or schedule when scheduledAt is set |
update_post |
Edit a draft or scheduled post: caption, media, one channel's settings, or its time |
publish_post |
Queue an immediate publish; returns a job run |
mark_post_posted |
Record that a person posted a manual-reminder or TikTok-inbox post |
delete_post |
Delete a draft, or cancel a post before it reaches any platform; published posts are refused |
bulk_posts |
Reschedule or restatus up to 25 posts |
create_posts |
Up to 25 posts in one call, per-item results |
upload_media |
Upload from a file path, URL, or data URL; returns the asset id |
list_media, get_media |
Uploaded assets, processing state, reference counts |
get_analytics |
Brand performance over a window: totals, channels, daily series, top posts, heatmap, insights. Covers posts published through Markaestro and posts published directly on the platform |
list_post_analytics |
Every post in the window with its latest metrics and source, sortable by views, reach, engagements, or engagement rate |
get_post_analytics_history |
The 1h to 90d metric snapshots of one post, with growth between stages |
refresh_analytics |
Pull live metrics from the platforms now (a few calls a minute) |
suggest_post_times |
The brand's best posting windows, learned from its own history |
get_job_run, list_job_runs |
Follow a publish to succeeded or failed |
get_channel_rules |
Per-channel media, caption, and delivery-mode rules |
get_tiktok_posting_options |
The TikTok creator's live privacy levels and interaction options, needed for a Direct Post |
The Evergreen tools (preview_, create_, get_, list_, update_,
activate_, pause_, and resume_evergreen_queue, list_evergreen_runs,
get_evergreen_analytics) manage proven recurring content.
Agents manage social media and nothing else: account settings, billing,
team, API keys, webhooks, and channel connections are not exposed, and no
tool deletes a published post, takes one down from a platform, or archives
an Evergreen queue. Those stay with the user in Markaestro. The same rule
holds at the REST layer for a key issued through the agent sign-in: it
cannot remove a published post, take one down from a platform, or manage
webhooks (FORBIDDEN_AGENT_CONNECTION). A key a person mints in Settings
keeps the full REST surface its scopes allow.
Also served: the markaestro://channel-rules resource and a schedule_post
prompt that walks an agent through a safe scheduling flow.
Posting is draft-first. create_post without scheduledAt never publishes;
publish_post is the only tool that publishes now, and its description tells
the agent to confirm with the user first.
Two ways to connect
Hosted (nothing to install, nothing to paste). Markaestro serves the
same tools over Streamable HTTP at https://markaestro.com/api/public/v1/mcp.
Add it with no credentials and the first tool call opens the browser: sign
in, pick the workspace and brand, click Allow. The client receives an API key
bound to that brand and refreshes it on its own.
claude mcp add --transport http markaestro https://markaestro.com/api/public/v1/mcp
This is standard OAuth 2.1 (PKCE, dynamic client registration, discovery at
/.well-known/oauth-protected-resource and
/.well-known/oauth-authorization-server), so claude.ai, Cursor, and other
MCP clients connect the same way. Connected agents are listed and revoked in
Settings, API.
For headless or CI use, pass a workspace API key as a bearer header instead:
claude mcp add --transport http markaestro https://markaestro.com/api/public/v1/mcp \
--header "Authorization: Bearer mk_live_..."
{
"mcpServers": {
"markaestro": {
"type": "http",
"url": "https://markaestro.com/api/public/v1/mcp",
"headers": { "Authorization": "Bearer mk_live_..." }
}
}
}
Send x-markaestro-read-only: 1 as an extra header to get only the reading
tools.
Local package. Run the server on your machine over stdio, which also
lets upload_media read local files:
Setup
- Create an API key in Markaestro under Settings > API Access. Pick the brand,
the scopes the agent needs (
products.read,posts.read,posts.write,media.write, andposts.publishif it may publish), and prefer a test key while you evaluate. - Give the key to the server through
MARKAESTRO_API_KEY.
Claude Code
claude mcp add markaestro -e MARKAESTRO_API_KEY=mk_live_... -- npx -y @markaestro/mcp
Claude Desktop, Cursor, and other JSON configs
{
"mcpServers": {
"markaestro": {
"command": "npx",
"args": ["-y", "@markaestro/mcp"],
"env": { "MARKAESTRO_API_KEY": "mk_live_..." }
}
}
}
Environment
| Variable | Required | Default |
|---|---|---|
MARKAESTRO_API_KEY |
yes | n/a |
MARKAESTRO_BASE_URL |
no | https://markaestro.com |
MARKAESTRO_READ_ONLY |
no | unset; 1 registers only reading tools |
What the server does for you
- Sends an
Idempotency-Keyon every mutation, minted once per call, so a retried request replays instead of double-posting. - Retries
429and transient5xxresponses using the server'sRetry-After. - Runs the three-step direct media upload (session,
PUTto storage, finalize) and never sends the API key to the storage URL. - Returns API failures as tool errors with the stable error
code, any per-channelissues, and a hint about what to change.
Claude Code plugin
The skill and the hosted server ship together as a plugin:
claude plugin marketplace add markaestro/markaestro-agents
claude plugin install markaestro@markaestro
Deploying
Maintainers: the full release runbook (every surface, the version files, and the exact
commands) is docs/operations/mcp-release.md in the Markaestro app repository. Summary:
| Surface | How it ships |
|---|---|
Hosted MCP (/api/public/v1/mcp) |
Part of the Next.js app; deploys on push to main like every route |
@markaestro/mcp on npm |
cd mcp && npm version <x.y.z> && npm publish (public scoped package; prepublishOnly builds). Bump src/version.ts with it |
| Plugin and skill | Mirrored to the public repo markaestro/markaestro-agents with node scripts/sync-agents-repo.mjs <clone>, then pushed there; claude plugin marketplace add markaestro/markaestro-agents reads it. The skill alone can be copied to ~/.claude/skills/markaestro |
MCP Registry (com.markaestro/mcp) |
After the npm publish of the same version: mcp-publisher login http --domain markaestro.com --private-key <hex> then mcp-publisher publish from mcp/. The public key is served at /.well-known/mcp-registry-auth |
Glama (markaestro/markaestro-agents) |
Admin, Dockerfile: build step npm install -g @markaestro/mcp@<version>, CMD markaestro-mcp; Build, then Create Release |
Development
cd mcp
npm install
npm run build
MARKAESTRO_API_KEY=mk_test_... MARKAESTRO_BASE_URL=http://localhost:3000 npm run smoke # local stdio
MARKAESTRO_API_KEY=mk_test_... MARKAESTRO_BASE_URL=http://localhost:3000 npm run smoke -- --remote # hosted endpoint
Unit tests live in src/__tests__ and run with the repository's npm test.
The smoke script starts the built server over stdio, lists tools, reads the
brand, creates a draft, reads it back, and deletes it. Nothing is published.
Markaestro MCP 질문
Markaestro MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp -- npx -y @markaestro/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Markaestro MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Markaestro MCP는 어떤 도구를 제공하나요?
18개 도구를 제공합니다. 예: list_products, list_destinations, get_brand_profile, create_post, update_post.
AI agent가 이미 발행된 게시물을 삭제할 수 있나요?
아니요, agent는 이미 발행된 게시물을 삭제하거나 플랫폼에서 내리거나 Evergreen 대기열을 보관할 수 없습니다. 이러한 작업은 사용자가 직접 수행해야 합니다.
서버에서 중복 게시 요청을 어떻게 처리하나요?
서버는 모든 mutation에 Idempotency-Key를 전송하므로, 요청을 재시도하더라도 중복 게시물이 생성되지 않고 원래 작업이 그대로 실행됩니다.
서버를 읽기 전용 모드로 사용할 수 있는 방법이 있나요?
네, x-markaestro-read-only: 1 헤더를 보내면 읽기 전용 도구만 제공받을 수 있습니다.
서버에서 로컬 파일 업로드를 지원하나요?
네, stdio를 통해 서버를 로컬에서 실행하면 upload_media 도구가 로컬 머신의 파일을 읽을 수 있습니다.