Instagram MCP Server
qaassimq/instagram-mcp-server
Instagram via Meta's official Graph API: publishing, comments, DMs, insights and discovery.
- tools
- 42
- auth
- Secret needed
- transport
- STDIO
- env vars
- 6
- last updated
- Nov 11, 2026
Tools
42 toolsPublic tool metadata for what this MCP can expose to an agent.
instagram_get_accountProfile plus a capability report for the active mode. Call this first.
Profile plus a capability report for the active mode. Call this first.
No parameter schema in public metadata yet.
instagram_get_publishing_limitQuota used of the 100-post / 24h cap
Quota used of the 100-post / 24h cap
No parameter schema in public metadata yet.
instagram_get_token_infodebug_token on facebook_login; liveness check on instagram_login
debug_token on facebook_login; liveness check on instagram_login
No parameter schema in public metadata yet.
instagram_refresh_tokenExtends a long-lived token. Returns it — does not persist it.
Extends a long-lived token. Returns it — does not persist it.
No parameter schema in public metadata yet.
instagram_list_pagesfacebook_login only. Finds your IG_USER_ID.
facebook_login only. Finds your IG_USER_ID.
No parameter schema in public metadata yet.
instagram_publish_image
No parameter schema in public metadata yet.
instagram_publish_reel
No parameter schema in public metadata yet.
instagram_publish_story
No parameter schema in public metadata yet.
instagram_publish_carousel
No parameter schema in public metadata yet.
instagram_create_containerEscape hatch for parameters the high-level tools do not expose.
Escape hatch for parameters the high-level tools do not expose.
No parameter schema in public metadata yet.
instagram_get_container_status
No parameter schema in public metadata yet.
instagram_publish_container
No parameter schema in public metadata yet.
instagram_list_media
No parameter schema in public metadata yet.
instagram_get_media
No parameter schema in public metadata yet.
instagram_get_media_children
No parameter schema in public metadata yet.
instagram_list_stories
No parameter schema in public metadata yet.
instagram_list_tagged_media
No parameter schema in public metadata yet.
instagram_delete_mediafacebook_login only
facebook_login only
No parameter schema in public metadata yet.
instagram_list_comments
No parameter schema in public metadata yet.
instagram_get_comment
No parameter schema in public metadata yet.
instagram_list_comment_replies
No parameter schema in public metadata yet.
instagram_create_comment
No parameter schema in public metadata yet.
instagram_reply_to_comment
No parameter schema in public metadata yet.
instagram_hide_comment
No parameter schema in public metadata yet.
instagram_delete_comment
No parameter schema in public metadata yet.
instagram_toggle_media_comments
No parameter schema in public metadata yet.
instagram_list_conversations
No parameter schema in public metadata yet.
instagram_get_conversationReports whether the 24-hour reply window is still open.
Reports whether the 24-hour reply window is still open.
No parameter schema in public metadata yet.
instagram_send_message
No parameter schema in public metadata yet.
instagram_send_media_message
No parameter schema in public metadata yet.
instagram_mark_seen
No parameter schema in public metadata yet.
instagram_list_metric_catalogMakes no API call and lists exactly what is valid.
Makes no API call and lists exactly what is valid.
No parameter schema in public metadata yet.
instagram_get_account_insights
No parameter schema in public metadata yet.
instagram_get_media_insights
No parameter schema in public metadata yet.
instagram_get_audience_demographics
No parameter schema in public metadata yet.
instagram_get_story_insightsReads every live story in one call.
Reads every live story in one call.
No parameter schema in public metadata yet.
instagram_get_mentioned_comment
No parameter schema in public metadata yet.
instagram_get_mentioned_media
No parameter schema in public metadata yet.
instagram_reply_to_mention
No parameter schema in public metadata yet.
instagram_search_hashtagfacebook_login only
facebook_login only
No parameter schema in public metadata yet.
instagram_get_hashtag_mediafacebook_login only
facebook_login only
No parameter schema in public metadata yet.
instagram_business_discoveryfacebook_login only
facebook_login only
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
IG_ACCESS_TOKEN*secretLong-lived Instagram access token: an IGAA... token on instagram_login, or a long-lived Page or User token with the instagram_* scopes on facebook_login.
IG_AUTH_MODEdefault: instagram_loginWhich Meta API path to use. instagram_login needs no Facebook Page (37 tools). facebook_login needs a linked Page and adds hashtag search, business discovery, Page listing and media deletion (42 tools).
IG_USER_IDInstagram professional account ID. Optional on instagram_login; required on facebook_login (find it with instagram_list_pages).
IG_API_VERSIONdefault: v26.0Graph API version to pin.
IG_APP_IDMeta app ID. Needed only for instagram_get_token_info and instagram_refresh_token on facebook_login.
IG_APP_SECRETsecretMeta app secret. Needed only for instagram_get_token_info and instagram_refresh_token on facebook_login.
Readme
instagram-mcp-server
An MCP server for Meta's official Instagram Platform APIs. 37–42 tools covering publishing, media, comments, direct messages, insights, and discovery.
No private endpoints, no scraping, no session cookies, no username/password login.
Every call goes to graph.instagram.com or graph.facebook.com with an OAuth token
you issued yourself.
- TypeScript, MCP SDK v2 (
@modelcontextprotocol/server), Zod 4 - stdio and Streamable HTTP transports
- Graph API v26.0 by default, pinnable
- Supports both of Meta's Instagram configurations from one codebase
Which auth mode do you want?
Meta ships two different Instagram APIs. This server implements both; IG_AUTH_MODE
picks one at startup, and only the tools that mode can actually serve get registered.
Details
- Repository
- github.com/qaassimq/instagram-mcp-server
- Category
- Media & Entertainment
- Package
@qaassim/instagram-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
