Referensi tool
Semua tool yang disediakan MCP server PostNext, beserta input, bentuk respons, dan contoh siap salin.
https://mcp.postnext.io/apiPOST https://mcp.postnext.io/apiAutentikasi
Setiap request ke https://mcp.postnext.io/api butuh header Authorization dengan Bearer token. Ada dua cara untuk mendapatkannya.
OAuth (disarankan untuk client AI)
Client AI menjalankan Dynamic Client Registration saat pertama kali terhubung, lalu memandu pengguna melewati layar persetujuan OAuth. Halaman /mcp/connect menangani ini secara otomatis. Client Anda menerima access token 30 hari.
API key
Untuk script dan CI, buat API key pribadi di aplikasi PostNext lewat Account → API Keys. Key ini diawali apikey_ dan dikirim sebagai bearer token seperti token lainnya.
Endpoint
Semua panggilan tool dikirim ke satu endpoint JSON-RPC 2.0 lewat HTTPS POST.
Tool
list_scheduled_posts
Tampilkan postingan terjadwal Anda (sudah masuk antrean, tetapi belum terkirim).
Argumen
limitfromHasil
Objek berisi posts: [{id, platform, content, scheduledAt, status}]. Maksimal sebanyak limit.
Contoh
curl -X POST https://mcp.postnext.io/api \
-H "Authorization: Bearer apikey_xxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/call","id":1,
"params":{"name":"list_scheduled_posts",
"arguments":{"limit":5}}}'
list_drafts
Tampilkan draf postingan Anda (belum dijadwalkan).
Argumen
limitHasil
Objek berisi drafts: [{id, platform, content, updatedAt}]. Maksimal sebanyak limit.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":2,
"params":{"name":"list_drafts","arguments":{"limit":10}}}
list_connected_accounts
Tampilkan akun media sosial yang terhubung ke tim Anda.
Argumen
Tanpa argumen.
Hasil
Objek berisi accounts: [{platform, handle, providerId, connected, lastSyncAt}].
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":3,
"params":{"name":"list_connected_accounts","arguments":{}}}
get_account_healthPaket berbayar
Dapatkan ringkasan kesehatan untuk semua platform yang terhubung.
Argumen
platformwindowDaysHasil
Objek berisi windowDays, postsScheduled, postsPublished, postsFailed, rincian byPlatform, dan topErrors[].
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":4,
"params":{"name":"get_account_health",
"arguments":{"windowDays":30}}}
create_post_draft
Buat draf postingan baru. Draf tidak terbit otomatis.
Argumen
platformcontentchannelNameproviderIdmediaUrlsclientRequestIdHasil
Objek berisi draf baru: {id, platform, content, status: "DRAFT", createdAt}.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":5,
"params":{"name":"create_post_draft",
"arguments":{"platform":"twitter",
"content":"Hello from MCP"}}}
update_post_draft Paket berbayar
Perbarui draf yang sudah ada. Minimal salah satu dari content atau mediaUrls harus diisi.
Argumen
postIdcontentmediaUrlsclientRequestIdHasil
Objek berisi draf yang diperbarui: {id, platform, content, mediaUrls, status, updatedAt}.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":6,
"params":{"name":"update_post_draft",
"arguments":{"postId":"",
"content":"Updated copy"}}}
connect_channel
Buat URL sekali pakai yang bisa dibuka pengguna untuk memberi izin koneksi platform baru.
Argumen
platformHasil
Objek berisi authUrl (link sekali pakai yang dibuka pengguna untuk memberi izin), expiresAt, dan platform.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":7,
"params":{"name":"connect_channel",
"arguments":{"platform":"linkedin"}}}
schedule_post
Pindahkan draf (status DRAFT) ke antrean terbit pada timestamp di masa depan. Idempoten dalam selisih ±60 detik; menolak percobaan jadwal ulang di waktu lain tanpa membatalkannya secara eksplisit lebih dulu. Dihitung dari jatah postingan bulanan paket (Free: 10, berbagi dengan aplikasi); satu postingan dihitung sekali, jadi menjadwalkannya ulang setelah dibatalkan atau gagal terbit tidak dihitung lagi.
Argumen
postIdscheduledAtHasil
Objek berisi postId, scheduledAt (ISO), status: SCHEDULED.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":8,
"params":{"name":"schedule_post",
"arguments":{"postId":"",
"scheduledAt":"2026-05-10T09:00:00Z"}}}
cancel_scheduled_post
Batalkan postingan terjadwal dan keluarkan dari antrean terbit. Draf di baliknya tetap tersimpan.
Argumen
postIdHasil
Objek berisi postId dan status: CANCELLED.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":9,
"params":{"name":"cancel_scheduled_post",
"arguments":{"postId":""}}}
delete_draft
Hapus draf postingan secara permanen. Menolak postingan yang bukan DRAFT (pakai cancel_scheduled_post untuk SCHEDULED).
Argumen
postIdHasil
Objek berisi postId dan deleted: true.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":10,
"params":{"name":"delete_draft",
"arguments":{"postId":""}}}
get_post
Mengembalikan PostGroup lengkap untuk postId tertentu, dengan konten per platform + status + timestamp.
Argumen
postIdHasil
Objek berisi postId, status, scheduledAt, createdAt, updatedAt, dan providers (record platform → konten).
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":11,
"params":{"name":"get_post",
"arguments":{"postId":""}}}
search_posts
Pencarian substring (tidak peka huruf besar/kecil) di konten postingan untuk tim aktif. Filter: status, platform, limit (1-100, default 20).
Argumen
querystatusplatformlimitHasil
Objek berisi posts: [{postId, status, platforms, snippet, scheduledAt, updatedAt}]. Snippet berisi konteks yang cocok dengan elipsis di kedua sisinya.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":12,
"params":{"name":"search_posts",
"arguments":{"query":"launch","limit":10}}}
list_teams
Mengembalikan tim yang dimiliki pengguna terautentikasi atau yang ia kelola sebagai admin, dengan tanda pada tim yang sedang aktif.
Argumen
Tanpa argumen.
Hasil
Objek berisi currentTeamId dan teams: [{teamId, teamName, isCurrent}].
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":13,
"params":{"name":"list_teams","arguments":{}}}
set_current_team
Ganti tim aktif untuk Bearer token ini. Pengguna harus menjadi anggota tim itu. Disimpan di dokumen OAuth token; perubahan di dalam sesi membuatnya langsung berlaku untuk tool berikutnya dalam percakapan yang sama.
Argumen
teamIdHasil
Objek berisi teamId, teamName, persisted (true jika OAuth, false jika API key), dan note opsional.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":14,
"params":{"name":"set_current_team",
"arguments":{"teamId":"team_xxxxx"}}}
get_plan_limits
Baca tier langganan pengguna saat ini dan kuota per tier (channel, penyimpanan, kredit AI, posting). Tersedia di setiap paket. Berguna sebelum memakai tool yang mengubah data, untuk memperkirakan apakah panggilan akan diblokir.
Argumen
Tanpa argumen.
Hasil
Objek berisi tier, tierDisplayName, isPaid, isTrial, limits (channels/storage/aiCalls masing-masing sebagai {limit, current, exceeded}; posts sebagai {limit, allowed, current}, dengan current berisi jumlah bulan ini, atau null jika tidak bisa dibaca), dan creditsAvailable ({total, subscriptionRemaining, purchasedBalance} atau null).
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":15,
"params":{"name":"get_plan_limits","arguments":{}}}
get_post_metrics
Mengambil metrik engagement untuk postingan yang sudah terbit di setiap platform tujuannya. Twitter mengembalikan likes, retweet, balasan, dan impresi; Instagram mengembalikan likes dan komentar. LinkedIn, Threads, dan TikTok hanya mengembalikan status terbit dan URL (pengumpulan engagement ditunda ke rilis berikutnya). Rekap total yang dinormalisasi menjumlahkan metrik dari platform mana pun yang melaporkannya.
Argumen
postId ID postingan PostNext dari panggilan list.
Hasil
Objek berisi postId, status, providers: [{platform, publishedPostId, publishedUrl, publishedAt, status, metrics}] dan totals: {likes, comments, shares, impressions}. metrics adalah objek berisi jumlah numerik per platform, atau null jika platform belum mengumpulkan engagement.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":16,
"params":{"name":"get_post_metrics",
"arguments":{"postId":""}}}
get_publish_status
Mendiagnosis apa yang terjadi pada postingan terjadwal: status antrean, sukses/error per platform, waktu pemrosesan, dan job id worker. Mengembalikan isScheduled=false untuk postingan yang ada sebagai draf tetapi belum pernah dipindahkan ke antrean terbit, dengan hint yang mengarah ke schedule_post.
Argumen
postId ID postingan PostNext dari panggilan list.
Hasil
Objek berisi postId, isScheduled, status, scheduledAt, publishedAt, platforms, processingTimeMs, jobId, topLevelError, dan results: [{platform, success, publishedPostId, publishedAt, error}]. Menyertakan hint jika isScheduled bernilai false.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":17,
"params":{"name":"get_publish_status",
"arguments":{"postId":""}}}
update_brand_profile Paket berbayar
Memperbarui sebagian profil brand aktif milik pengguna. Field yang diizinkan: bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize. Field lain dibuang tanpa pemberitahuan. "Aktif" ditentukan dari default tim lebih dulu, lalu profil aktif pertama milik pengguna sendiri.
Argumen
brandVoice Array deskriptor gaya bahasa brand (mis. ["professional", "concise"]).
Other patchable fields: bio, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize.
Hasil
Objek berisi profileId, name, updated: [nama field yang diperbarui], dan nilai terkini bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize setelah pembaruan.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":18,
"params":{"name":"update_brand_profile",
"arguments":{"brandVoice":["professional","concise"]}}}
get_best_time_to_post Paket berbayar
Merekomendasikan N slot teratas (dayOfWeek, hour) untuk postingan berikutnya di platform tertentu, berdasarkan 90 hari terakhir. Twitter dan Instagram diurutkan berdasarkan engagement per postingan; LinkedIn, Threads, dan TikTok hanya berdasarkan frekuensi posting. Waktu memakai zona waktu IANA yang diberikan (default UTC). Butuh paket berbayar.
Argumen
platform Platform media sosial: twitter, instagram, linkedin, threads, atau tiktok.
timezone Nama zona waktu IANA (mis. Europe/Berlin, America/New_York). Default-nya UTC.
topN Jumlah rekomendasi slot yang dikembalikan (1-24, default 5).
Hasil
Objek berisi platform, timezone, sampleWindowDays, sampleSize, metricsAvailable, dan recommendations: [{dayOfWeek (1-7, Senin=1), dayLabel, hour (0-23), score, basedOn: {posts, avgEngagement}}]. Menyertakan hint untuk kasus cold start atau metrik tidak tersedia.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":19,
"params":{"name":"get_best_time_to_post",
"arguments":{"platform":"twitter","timezone":"Europe/Berlin","topN":5}}}
get_channel_analytics
Performa gabungan untuk satu channel terhubung, atau untuk semua channel sekaligus. Mengembalikan impresi, reach, likes, komentar, dan engagement rate untuk periode itu, perubahan dibanding periode sebelumnya dengan panjang yang sama, serta deret data followers. Kosongkan platform untuk total seluruh tim. Pakai get_post_metrics untuk satu postingan dan get_best_time_to_post untuk penjadwalan.
Argumen
platform Platform media sosial: twitter, instagram, linkedin, threads, atau tiktok.
channelName Akun terhubung yang mana, jika platform itu punya lebih dari satu.
providerId providerId akun dari list_connected_accounts. Nilainya tetap sama saat handle berubah, jadi kirimkan bersama channelName atau sebagai penggantinya.
period Rentang laporan: 7d, 30d, 90d, atau all (default 30d).
Hasil
Objek berisi scope, period, totals, vsPrevious, coverage, dataThrough, dan followers, yang memuat trackingSince, current, change, dan deret datanya.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":34,
"params":{"name":"get_channel_analytics",
"arguments":{"platform":"linkedin","period":"30d"}}}search_tools
Mencari di katalog tool MCP berdasarkan kueri teks bebas, kategori, atau tujuan. Mengembalikan kategori, requiresScope, deskripsi satu baris, dan tag use case yang cocok. Gratis untuk semua paket (fitur untuk menemukan tool).
Argumen
Semuanya opsional. Panggil tanpa argumen untuk menampilkan semua tool yang tersedia.
query Pencarian teks bebas di nama tool, deskripsi, dan tag use case.
category Filter ke satu kategori: posts, accounts, analytics, brand, teams, discovery, other.
Hasil
Objek berisi totalTools, matchCount, categories: [string[]], dan tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}]. Menyertakan hint jika tidak ada yang cocok atau tidak ada filter.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":20,
"params":{"name":"search_tools",
"arguments":{"query":"why did my post fail"}}}
get_plan
Identitas paket dan tanggal penagihan: tier, tanggal perpanjangan, tanggal akhir uji coba, dan apakah langganan diatur untuk dibatalkan di akhir periode. Untuk kuota dan pemakaian, panggil get_plan_limits.
Argumen
Tanpa argumen.
Hasil
Objek berisi tier, tierDisplayName, isPaid, isTrial, gated, subscriptionStatus, renewsAt, trialEndsAt, cancelAtPeriodEnd, dan currency.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":21,
"params":{"name":"get_plan",
"arguments":{}}}
upload_asset
Unggah inline gambar atau video dalam base64 ke library aset. Hanya andal untuk file yang sangat kecil, sekitar 8KB atau kurang: payload yang lebih besar terpotong tanpa peringatan di argumen tool dan menyimpan file yang rusak. Pakai request_asset_upload untuk file yang lebih besar.
Argumen
filename Nama file beserta ekstensinya, maksimal 255 karakter.
contentType MIME type file, dari daftar gambar dan video yang diizinkan.
base64 Byte file, di-encode base64. Buat sekecil mungkin, dan baca dulu peringatan di atas.
Hasil
Objek berisi assetId, url, sizeBytes, dan mimeType. Kirim url ke create_post_draft sebagai mediaUrls.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":22,
"params":{"name":"upload_asset",
"arguments":{"filename":"logo.png","contentType":"image/png","base64":"iVBORw0KGgo..."}}}
request_asset_upload
Cara unggah yang disarankan, untuk gambar dan video ukuran berapa pun. Dua langkah: panggil tool ini untuk mendapat pre-signed URL dan perintah curl yang siap pakai, lalu kirim byte file dengan PUT ke URL itu. Respons PUT berisi URL aset final.
Argumen
filename Nama file beserta ekstensinya, maksimal 255 karakter.
contentType MIME type file, dari daftar gambar dan video yang diizinkan.
sizeBytes Ukuran file persis dalam byte, dipakai untuk menandatangani unggahan.
Hasil
Objek berisi uploadId, uploadUrl, uploadToken, expiresInSeconds, dan instructions yang memuat perintah PUT persisnya.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":23,
"params":{"name":"request_asset_upload",
"arguments":{"filename":"clip.mp4","contentType":"video/mp4","sizeBytes":4194304}}}
import_chat_file
Khusus ChatGPT. Menyimpan gambar dan video yang dilampirkan di chat ke library aset Anda, siap untuk create_post_draft. ChatGPT mengirim tiap file sebagai link sementara; PostNext mengunduhnya sekali lewat HTTPS dan memeriksa dari file itu sendiri bahwa isinya gambar atau video. Maksimal 10 file per panggilan, masing-masing 50 MB, dihitung dari penyimpanan paket Anda (total 10 MB di paket Free).
Argumen
files Diisi oleh ChatGPT dari file yang dilampirkan di chat: download_url dan file_id, serta mime_type dan file_name jika ada. Maksimal 10. Client lain mengunggah dengan request_asset_upload.
Hasil
Objek berisi files (assetId, url, sizeBytes, mimeType, dan fileName untuk tiap file yang tersimpan) dan failed (fileName dan alasan untuk tiap file yang gagal disimpan). Jika tidak ada file yang bisa disimpan, panggilan ini mengembalikan error file pertama.
Contoh
{"jsonrpc":"2.0","method":"tools/call","id":35,
"params":{"name":"import_chat_file",
"arguments":{"files":[{"download_url":"https://files.oaiusercontent.com/...","file_id":"file_abc123"}]}}}
Resource MCP
Resource adalah konteks hanya-baca yang bisa diambil client lewat metode MCP resources/read. Claude mengambilnya di awal percakapan, jadi Claude sudah punya konteks akun/tim/brand tanpa perlu Anda jelaskan ulang di setiap sesi.
postnext://account/summary
Email dan handle akun (agar Claude bisa memastikan akun mana yang sedang dipakainya), paket, kredit AI terpakai / batas, jumlah draf, jumlah terjadwal, jumlah channel terhubung. Tiap jumlah dibatasi maksimal 100 agar cepat dimuat.
postnext://channels/connected
Bentuknya sama dengan hasil list_connected_accounts; disediakan sebagai resource agar Claude mengambilnya sekali di awal percakapan (tanpa bolak-balik pemanggilan tool).
postnext://brand-profiles/active
Profil brand aktif milik pengguna (default tim, jika tidak ada memakai profil milik sendiri yang pertama). Hanya mengembalikan field yang relevan untuk LLM: bio, expertiseAreas, personalityTraits, brandVoice, mainThemes, audienceSize, preferredHashtags.
postnext://teams/current
Metadata tim saat ini (teamId, teamName) ditambah jumlah totalTeamsAvailable. Pakai bersama list_teams + set_current_team untuk berpindah tim.
Workflow bernama
Pintasan di menu slash yang menjalankan beberapa tool sekaligus. Pilih satu dan biarkan asisten AI Anda mengerjakan tugas bertahap, dengan konfirmasi sebelum mengubah apa pun.
/weekly-plan
Baca profil brand, channel terhubung, dan postingan di antrean, lalu usulkan 5-10 draf yang tersebar dari Senin sampai Jumat.
/draft-thread
Tulis thread Twitter atau Threads berisi 5-10 postingan tentang topik atau URL yang Anda berikan, dengan gaya bahasa brand Anda.
/audit-queue
Periksa postingan terjadwal 7 hari ke depan dan tandai duplikat, platform yang terlalu padat, dan hari yang kosong.
/channel-sweep
Bandingkan channel terhubung dengan daftar yang didukung dan sarankan mana yang perlu dihubungkan atau diperbarui.
Endpoint discovery dan OAuth
Metadata sesuai standar, jadi client MCP apa pun bisa mengatur dirinya secara otomatis.
GET /.well-known/oauth-protected-resource/api— RFC 9728GET /.well-known/oauth-authorization-server— RFC 8414GET /oauth/.well-known/openid-configuration— OIDCPOST /oauth/reg— Dynamic Client Registration (RFC 7591)GET /oauth/auth— Authorize (PKCE-S256 required)POST /oauth/token— Token exchange
Open source
Resep siap tempel dan referensi untuk developer ada di repo dokumentasi publik kami. Berlisensi MIT; pull request dipersilakan. github.com/postnextio/postnext-mcp
MCP server media sosial untuk Claude, ChatGPT, dan AI agent apa pun
MCP server media sosial PostNext memungkinkan Claude, ChatGPT, dan AI agent apa pun merencanakan, membuat draf, dan menjadwalkan postingan. Draf menunggu di kalender Anda sampai Anda menjadwalkannya.