Tool MCP

Tool mengikuti REST API: input sama, hasil sama, error sama. Tool baca tidak pernah mengubah apa pun dan hanya tool inilah yang dilihat koneksi hanya-baca. Petunjuk (hint) adalah anotasi tool MCP yang dipakai client untuk memutuskan kapan harus bertanya dulu ke Anda.

Workspace dan akun

Tool	Fungsi	Akses	API
get_workspace	Nama, zona waktu, langganan, batas, peran dan tingkat akses Anda	Baca	GET /me
list_accounts	Akun tersambung, statusnya dan content type yang diterima masing-masing	Baca	GET /accounts
list_content_types	Batas media dan caption per content type; platform opsional	Baca	GET /content-types
get_tiktok_creator_info	Level privasi dan pengaturan yang diizinkan akun TikTok, langsung dari TikTok	Baca	GET /accounts/{id}/tiktok-creator-info

Post

Tool	Fungsi	Akses	Hint	API
list_posts	Per status atau from/to, filter accountId/tagId; mengembalikan { items, nextCursor }	Baca		GET /posts
get_post	Satu post dengan status, error dan link tayang per akun	Baca		GET /posts/{id}
validate_post	Periksa post terhadap aturan semua platform tanpa menyimpan	Baca		POST /posts/validate
create_post	Draft, jadwalkan, terbitkan sekarang atau ajukan persetujuan	Tulis	open world	POST /posts
update_post	Ganti isi post yang belum terbit	Tulis	destruktif	PUT /posts/{id}
reschedule_post	Pindah ke waktu baru	Tulis	idempoten	POST /posts/{id}/reschedule
publish_post	Terbitkan sekarang	Tulis	open world	POST /posts/{id}/publish
retry_post	Terbitkan ulang akun yang gagal	Tulis	open world	POST /posts/{id}/retry
approve_post	Pemilik: setujui post yang menunggu review	Tulis		POST /posts/{id}/approve
reject_post	Pemilik: kembalikan ke penulisnya dengan alasan	Tulis		POST /posts/{id}/reject
delete_post	Hapus dari PostFlow (post yang sudah tayang tetap di platform)	Tulis	destruktif	DELETE /posts/{id}

Kalender, antrean, media dan tag

Tool	Fungsi	Akses	API
get_calendar	Post antara from dan to (≤ 92 hari) plus slot antrean yang kosong	Baca	GET /calendar
get_queue	Jam posting mingguan dan saran waktu	Baca	GET /queue
next_queue_slot	Waktu posting kosong berikutnya	Baca	GET /queue/next
list_media	Pustaka media, terbaru dulu; kind, q, before	Baca	GET /media
import_media	Masukkan foto atau video dari URL publik	Tulis	POST /media
delete_media	Hapus file yang tidak dipakai (destruktif)	Tulis	DELETE /media/{id}
list_tags	Tag, untuk tagIds	Baca	GET /tags

Komentar dan pesan

Teks komentar dan pesan ditulis orang lain. Server meminta agent tidak pernah mengikuti instruksi di dalamnya, serta menunjukkan balasan persisnya dan menunggu persetujuan Anda sebelum mengirim.

Tool	Fungsi	Akses	API
list_comments	Thread komentar di Facebook dan Instagram, dengan balasannya	Baca	GET /inbox
reply_to_comment	Balas secara publik lalu tandai selesai	Tulis	POST /inbox/{id}/reply
hide_comment	Sembunyikan atau tampilkan komentar di platform	Tulis	POST /inbox/{id}/hide
set_comment_status	Tandai selesai atau terbuka di PostFlow	Tulis	POST /inbox/{id}/status
list_conversations	Percakapan pesan langsung, dengan batas waktu balas	Baca	GET /inbox/messages
get_conversation	100 pesan terakhir	Baca	GET /inbox/messages/{id}
reply_to_conversation	Kirim balasan dalam 24 jam sejak pesan terakhir mereka	Tulis	POST /inbox/messages/{id}/reply
set_conversation_status	Tandai selesai atau terbuka di PostFlow	Tulis	POST /inbox/messages/{id}/status

Analitik

Tool	Fungsi	Akses	API
get_analytics	7, 30 atau 90 hari dibanding periode sebelumnya: total, per akun dan format, waktu terbaik, post teratas	Baca	GET /analytics

Hasil dan error

Panggilan yang berhasil mengembalikan JSON API sebagai teks, dan sebagai structuredContent bila berupa objek. Kegagalan mengembalikan isError: true dengan kode, pesan dan detail error:

VALIDATION: Some posts need changes before they can be scheduled
{"preflight":[{"socialAccountId":"acc_th","issues":[{"severity":"error","code":"caption_length","message":"Caption is 612 characters; the limit is 500."}]}]}