unofficial-instagram-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CDP_URL | No | Chrome DevTools Protocol address. | http://127.0.0.1:9222 |
| IG_DRY_RUN | No | When true, write tools simulate the final action. Set to false only when you are ready to perform real actions. | true |
| MAX_DELAY_MS | No | Maximum delay between browser actions, in milliseconds. | 7000 |
| MIN_DELAY_MS | No | Minimum delay between browser actions, in milliseconds. | 2500 |
| USER_DATA_DIR | No | Optional persistent browser profile. When set, the server opens that profile instead of connecting over CDP. Sign in manually once. | |
| IG_SELFTEST_FULL | No | Gate for the full self-test level. Must be true together with IG_DRY_RUN and IG_SELFTEST_ACCOUNT. | false |
| IG_SELFTEST_TARGET | No | Account used for the follow and restore step of the full self-test. | |
| IG_SELFTEST_ACCOUNT | No | Username the full self-test is allowed to run on. It refuses to run on any other account. | |
| IG_SELFTEST_DM_TARGET | No | Optional. Your own second account, used once for the dm_send_to_user step of the full self-test. | |
| IG_SELFTEST_ON_CONNECT | No | When true, the safe self-test runs once when the MCP server first connects. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Server ini mengendalikan Instagram Web lewat browser pemilik akun yang SUDAH login (bukan API Meta). Mulai dari ig_status. Tool baca aman dipanggil kapan saja; dm_list_threads/dm_check membuka thread dan bisa menandainya terbaca. Tool tulis (dm_send, post_like, post_comment, post_reply_to_comment, post_create, story_create, story_create_poll) berdampak nyata kecuali server berjalan dengan IG_DRY_RUN=true - hasil tool selalu menyatakan dryRun/sent apa adanya, percayai hasil itu. Jangan memanggil tool tulis berulang untuk pesan yang sama. Tool ig_selftest menjalankan pemeriksaan resmi: level safe hanya membaca; level full menguji semua fungsi tulis lalu menghapus konten tesnya sendiri, dan hanya boleh dijalankan di akun kedua.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ig_statusA | Cek koneksi browser & akun Instagram yang sedang login. Panggil ini pertama kali. |
| dm_list_threadsC | Daftar thread DM teratas (klik-scan, karena daftar IG menyusut jadi avatar). EFEK SAMPING: membuka thread dapat menandainya terbaca. |
| dm_checkB | Cek thread mana yang pesan terakhirnya dari lawan bicara (perlu dibalas). Baca saja, tidak membalas apa pun. |
| dm_read_threadB | Baca isi 1 thread DM: username, nama, dan pesan-pesan terakhir dengan arahnya (fromMe true = pesan akun sendiri). |
| dm_sendA | Kirim / balas pesan di thread DM yang sudah ada (berdasarkan threadId). AKSI TULIS: benar-benar terkirim kecuali IG_DRY_RUN=true. |
| dm_send_to_userB | Kirim DM ke username tertentu (buka profil, klik Message, lalu kirim). AKSI TULIS seperti dm_send. |
| profile_getA | Ambil info profil Instagram (bio, jumlah post/followers/following). Tanpa username = profil akun yang login. |
| searchC | Cari user & hashtag di Instagram dari kata kunci. |
| post_likeA | Like sebuah post/reel dari URL-nya. Idempotent: kalau sudah di-like, dilaporkan alreadyLiked. AKSI TULIS kecuali IG_DRY_RUN=true. |
| post_commentB | Komentar baru di post/reel dari URL-nya. AKSI TULIS kecuali IG_DRY_RUN=true. |
| post_reply_to_commentA | Balas SATU komentar spesifik di sebuah post: cari komentar yang memuat teks |
| post_createB | Buat post baru dari file gambar lokal + caption. Dengan IG_DRY_RUN=true berhenti tepat sebelum tombol Share. |
| user_postsC | Daftar post/reel terbaru dari profil seorang user (URL saja). Berguna untuk riset konten & monitoring kompetitor. |
| post_getB | Detail sebuah post/reel: penulis, waktu, jenis media, dan teks halaman (caption, jumlah like/komen bila tampil). |
| post_commentsA | Baca komentar-komentar sebuah post. Pasangan baca dari post_reply_to_comment: baca dulu, putuskan, baru balas. |
| feed_homeB | Intip timeline beranda akun yang login (postingan terbaru + penulisnya). |
| explore_postsC | Daftar post dari halaman Explore saat ini. |
| hashtag_postsC | Daftar post di halaman sebuah hashtag. Berguna untuk riset topik/niche. |
| media_urlsA | Ambil URL file gambar/video dari sebuah post (untuk diunduh/diolah agent). |
| user_followA | Follow seorang user. Idempotent: state Following/Requested dilaporkan apa adanya. AKSI TULIS kecuali IG_DRY_RUN=true. |
| user_unfollowA | Unfollow seorang user (dengan dialog konfirmasi IG). AKSI TULIS kecuali IG_DRY_RUN=true. |
| followers_listB | Daftar username followers seorang user (dari dialog followers). Batas hasil mengikuti yang dimuat IG. |
| following_listB | Daftar username yang di-follow seorang user (dari dialog following). |
| comment_likeB | Like satu komentar spesifik (cari yang memuat teks |
| post_saveB | Simpan (bookmark) sebuah post. Idempotent. AKSI TULIS kecuali IG_DRY_RUN=true. |
| notifications_listB | Baca panel notifikasi: like/komen/follow/mention terbaru ke akun yang login. Kunci untuk engagement: dari sini agent tahu siapa yang harus dibalas. |
| story_viewA | Buka story seorang user dan laporkan isinya secara ringkas. EFEK: story tertanda sudah dilihat. |
| story_replyB | Balas story seorang user dengan teks (masuk sebagai DM). AKSI TULIS kecuali IG_DRY_RUN=true. |
| post_deleteA | Hapus post MILIK SENDIRI dari URL-nya. Menolak bila penulisnya bukan akun yang login. AKSI TULIS kecuali IG_DRY_RUN=true. |
| stories_trayB | Daftar akun dengan story aktif di tray beranda saat ini (untuk memilih story mana yang dilihat). |
| story_createA | Buat story baru: dari file gambar, atau story teks (text) bila editor teks IG web tersedia untuk akun ini. BATASAN PLATFORM: Instagram Web tidak selalu menyediakan pintu pembuatan story (terverifikasi 16 Nov 2026: akun uji tidak punya entry point story sama sekali di web); tool melaporkan itu dengan jelas bila tidak tersedia. AKSI TULIS kecuali IG_DRY_RUN=true. |
| story_create_pollA | Buat story dengan stiker POLLING: question + 2 options (bawaan IG) di atas file gambar. Gagal dengan alasan jelas bila pembuatan story / stiker tidak tersedia di IG web akun ini; story tidak dibagikan bila polling gagal terpasang. AKSI TULIS kecuali IG_DRY_RUN=true. |
| story_deleteA | Hapus story aktif MILIK SENDIRI yang sedang tayang. AKSI TULIS kecuali IG_DRY_RUN=true. |
| ig_selftestA | Jalankan self-test resmi. Level "safe" (default): hanya tool baca, aman di akun mana pun. Level "full": menguji SEMUA tool tulis pada konten buatan sendiri lalu MENGHAPUS semuanya di akhir; gerbang keras IG_SELFTEST_FULL=true + IG_DRY_RUN=false + IG_SELFTEST_ACCOUNT harus sama dengan akun login. PERINGATAN: level full hanya di akun kedua, jangan akun utama. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 34 tools
The domain prefixes (dm_, post_, story_, user_) plus descriptors make most boundaries clear, and paired read/write tools are explicitly linked in their descriptions (post_comments ↔ post_reply_to_comment, stories_tray ↔ story_view). A few pairs still need care: story_create vs story_create_poll, dm_list_threads vs dm_check vs dm_read_thread, and post_get vs media_urls vs post_comments all touch the same resource and could be mispicked by a hurried agent.
Theming is recognizable but conventions are mixed: dm_list_threads/dm_read_thread/dm_send are verb-first, whereas post_like, post_get, user_follow, and profile_get are noun-first, and un-prefixed names like `search` sit alongside prefixed ones. The story family is also split between the singular `story_*` (view, reply, create, delete) and plural `stories_tray`, which breaks the otherwise tidy prefix scheme.
34 tools is heavy for a single-account browser automation surface, and a handful (media_urls, explore_posts, ig_selftest, story_create_poll) feel like variants rather than independent capabilities. That said, the breadth mirrors the real Instagram web surface (DMs, posts, comments, stories, social graph), so most tools map to a distinct UI action rather than bloat.
Read/write coverage is genuinely broad: DMs, posts, comments, stories, follows, search, feed/explore/hashtag browsing, notifications, and a documented self-test harness, with sane idempotency and dry-run semantics. The gaps are mostly inverse operations (unlike, unsave, delete comment, delete DM, block/report) and no post/profile editing, which agents can work around but leave the lifecycle slightly asymmetric.