Skip to main content
Glama
unofficial-instagram-mcp

unofficial-instagram-mcp

by fanyzp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CDP_URLNoChrome DevTools Protocol address.http://127.0.0.1:9222
IG_DRY_RUNNoWhen true, write tools simulate the final action. Set to false only when you are ready to perform real actions.true
MAX_DELAY_MSNoMaximum delay between browser actions, in milliseconds.7000
MIN_DELAY_MSNoMinimum delay between browser actions, in milliseconds.2500
USER_DATA_DIRNoOptional persistent browser profile. When set, the server opens that profile instead of connecting over CDP. Sign in manually once.
IG_SELFTEST_FULLNoGate for the full self-test level. Must be true together with IG_DRY_RUN and IG_SELFTEST_ACCOUNT.false
IG_SELFTEST_TARGETNoAccount used for the follow and restore step of the full self-test.instagram
IG_SELFTEST_ACCOUNTNoUsername the full self-test is allowed to run on. It refuses to run on any other account.
IG_SELFTEST_DM_TARGETNoOptional. Your own second account, used once for the dm_send_to_user step of the full self-test.
IG_SELFTEST_ON_CONNECTNoWhen 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

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 match, klik Reply, lalu kirim balasan. AKSI TULIS kecuali IG_DRY_RUN=true.

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 match). AKSI TULIS kecuali IG_DRY_RUN=true.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 34 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count3/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues