qaassimq avatar

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 tools

Public 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

Configuration

IG_ACCESS_TOKEN*secret

Long-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_login

Which 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_ID

Instagram professional account ID. Optional on instagram_login; required on facebook_login (find it with instagram_list_pages).

IG_API_VERSIONdefault: v26.0

Graph API version to pin.

IG_APP_ID

Meta app ID. Needed only for instagram_get_token_info and instagram_refresh_token on facebook_login.

IG_APP_SECRETsecret

Meta app secret. Needed only for instagram_get_token_info and instagram_refresh_token on facebook_login.

Readme

instagram-mcp-server

npm version CI

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.


View the full README on GitHub

Details

Repository
github.com/qaassimq/instagram-mcp-server
Category
Media & Entertainment
Package
@qaassim/instagram-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Media & Entertainment MCP servers

View all
1roilo-co avatarRoilo: UGC Video Ads From a Few Product or Venue Photosroilo-co/ai-product-video-apiTurn a few product or venue photos into a usable UGC video ad: script, actor, voiceover, captions.0stars
2ariadne-coil avatarFuture Video Studioariadne-coil/fvs-mcpCreate and manage cinematic AI video renders through the Future Video Studio Agent API.0stars
3windows10fan648 avatarYouTube Transcript MCPwindows10fan648/youtube-transcript-mcpFetches public YouTube caption tracks with timestamps and exact language selection.0stars
4zsthimself avatarOpenVideoGenerator MCP Serverzsthimself/open-video-generator-mcpAI video generation MCP server for Kling, MiniMax, Luma & Hunyuan with prompt blueprints.0stars
5woven-record-media avatarWeftlywoven-record-media/weftly-monorepoFind & cut horizontal and vertical video clips (Shorts/Reels), transcribe & summarize. Pay per job.0stars
6totalaudiopromo avatarTap Mcptotalaudiopromo/total-audio-platformMusic PR campaign management -- contacts, pitches, campaigns, and outcomes.0stars