AI agent'larının Markaestro API aracılığıyla sosyal medya gönderilerini planlamasını, yayınlamasını, incelemesini ve marka analizlerini yönetmesini sağlayın.
Ayrıca bilinen adı markaestro/markaestro-agents, mcp, @markaestro/mcp
- Yıldızlar
- 0
- Araçlar
- 18
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.5.0
- Son commit
- 13 Kas 2026
- Lisans
- MIT
Markaestro MCP nedir?
AI agent'larının Markaestro API aracılığıyla sosyal medya gönderilerini planlamasını, yayınlamasını, incelemesini ve marka analizlerini yönetmesini sağlayın. 18 araç sunar; örneğin list_products, list_destinations, get_brand_profile.
Özet, projenin README dosyasından oluşturuldu
Markaestro MCP sunucusu hakkında
Markaestro, AI agent'larının sosyal medya iş akışlarını tek bir arayüz üzerinden yönetmesini sağlayan bir MCP server sunar. Geliştiriciler; marka içeriklerini planlamak, yayınlamak ve incelemek için Claude, Cursor veya ChatGPT gibi istemcileri bağlayabilirler. Sunucu, OAuth 2.1 kullanarak HTTP üzerinden barındırılan bağlantıları ve stdio üzerinden yerel kurulumları destekler. Yerel kurulumlar, upload_media aracının dosyalara doğrudan makinenizden erişmesine olanak tanırken, barındırılan sürüm kurulum gerektirmez ve tarayıcı tabanlı bir oturum açma süreci kullanır.
Kullanıcılar, API anahtarı izinlerine bağlı olarak tek bir marka veya tüm bir çalışma alanı için içerik yönetebilirler. Araç seti; tekli veya toplu gönderi oluşturma, medya varlıklarını yönetme ve ayrıntılı analizler yoluyla performansı izleme yeteneklerini içerir. Ayrıca, yinelenen içerikleri yönetmek için evergreen araçlarına sahiptir. Güvenliği sağlamak amacıyla sunucu, yayınlamanın açık komutlar gerektirdiği bir taslak öncelikli yaklaşım izler; agent'ların faturalandırma, ekip ayarlarını değiştirme veya halihazırda yayınlanmış gönderileri silme yetkisi kısıtlanmıştır.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Markaestro MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMarkaestro MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp -- npx -y @markaestro/mcpMarkaestro MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Markaestro MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Markaestro MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@markaestro/mcp"],"env":{"MARKAESTRO_API_KEY":"<YOUR_MARKAESTRO_API_KEY>"}}'Markaestro MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Markaestro MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' -- npx -y @markaestro/mcpMarkaestro MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@markaestro/mcp"] [mcp_servers.mcp.env] MARKAESTRO_API_KEY = "<YOUR_MARKAESTRO_API_KEY>"
Markaestro MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp npx -- -y @markaestro/mcpMarkaestro MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markaestro/mcp"
],
"env": {
"MARKAESTRO_API_KEY": "<YOUR_MARKAESTRO_API_KEY>"
}
}
}
}Markaestro MCP araçları 18
README dosyasından algılandı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 aracın tümünü gösterDaha az araç göster
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 | — |
Yapılandırma
MARKAESTRO_API_KEYGerekliGizliWorkspace 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.
| Ad | Açıklama | Sunucu |
|---|---|---|
| MARKAESTRO_API_KEY | Workspace API key (mk_live_ or mk_test_) from Settings, API Access. Covers one brand or all brands in the workspace. | GerekliGizli |
| MARKAESTRO_READ_ONLY | Set to 1 to register only the reading tools. |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@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 soruları
Markaestro MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'MARKAESTRO_API_KEY=<YOUR_MARKAESTRO_API_KEY>' mcp -- npx -y @markaestro/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Markaestro MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Markaestro MCP hangi araçları sunar?
18 araç sunar; bunlar arasında list_products, list_destinations, get_brand_profile, create_post, update_post yer alır.
AI agent yayınlanmış gönderileri silebilir mi?
Hayır, agent yayınlanmış gönderileri silemez, bir platformdan kaldıramaz veya bir Evergreen kuyruğunu arşivleyemez; bu işlemler kullanıcı tarafından yapılmalıdır.
Sunucu mükerrer gönderi isteklerini nasıl yönetiyor?
Sunucu, her mutasyon işleminde bir Idempotency-Key gönderir; böylece yeniden denenen istekler mükerrer bir gönderi oluşturmak yerine orijinal işlemi tekrarlar.
Sunucuyu salt okunur modda kullanmanın bir yolu var mı?
Evet, yalnızca okuma araçlarını almak için x-markaestro-read-only: 1 başlığını gönderebilirsiniz.
Sunucu yerel dosya yüklemelerini destekliyor mu?
Evet, sunucuyu yerel olarak stdio üzerinden çalıştırmak, upload_media aracının dosyaları yerel makinenizden okumasına olanak tanır.