MCP server

Instagram

io.github.mcp-dir/instagram-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

33

Token cost

About 6,823 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http instagram-mcp https://api.mcp.ai/p_instagram

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.instagram-mcp]
url = "https://api.mcp.ai/p_instagram"

Gemini CLI

{"mcpServers":{"instagram-mcp":{"httpUrl":"https://api.mcp.ai/p_instagram"}}}

Cursor

{"mcpServers":{"instagram-mcp":{"url":"https://api.mcp.ai/p_instagram"}}}

VS Code

{"servers":{"instagram-mcp":{"type":"http","url":"https://api.mcp.ai/p_instagram"}}}

Antigravity

agy mcp add instagram-mcp https://api.mcp.ai/p_instagram

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"instagram-mcp","server_url":"https://api.mcp.ai/p_instagram","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"instagram-mcp","server_url":"https://api.mcp.ai/p_instagram"}

Tools

• instagram_actions_follow ~92 tokens
  Follow one or more Instagram users by @username. Returns a job_id.
• instagram_actions_get_job_status ~121 tokens
  Get the status/progress/result of a previously started action by its job_id. Bulk support: accepts job_ids for batched execution.
• instagram_actions_like ~123 tokens
  Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). Returns a job_id; poll instagram_actions_get_job_status.
• instagram_actions_like_comment ~152 tokens
  Like one or more comments. Each comment_id MUST come from instagram_actions_list_comments. The id returned by the official instagram_get_ig_media_comments belongs to a different namespace and is rejected. Returns a job_id; poll instagram_actions_get_job_status.
• instagram_actions_list_accounts ~76 tokens
  List the Instagram accounts connected to this install — id, username, label.
• instagram_actions_list_comments ~150 tokens
  List the comments on a post, addressed by URL or shortcode. Returns each comment_id in the form that instagram_actions_like_comment accepts. The official API returns a DIFFERENT id that is not accepted there. Returns a job_id; poll instagram_actions_get_job_status.
• instagram_actions_list_jobs ~98 tokens
  List recent action jobs for the connected account, optionally filtered by status.
• instagram_actions_list_stories ~116 tokens
  List a specific user's currently available stories (read-only, does not mark as seen). Returns a job_id (or the result inline when wait=true).
• instagram_actions_send_message Sends messages · ~133 tokens
  Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). One recipient per call, low daily cap. Returns a job_id.
• instagram_actions_unfollow ~94 tokens
  Unfollow one or more Instagram users by @username. Returns a job_id.
• instagram_actions_view_story ~101 tokens
  Watch (mark as seen) the stories of one or more profiles. Omit `targets` to watch the home tray. Returns a job_id.
• instagram_create_carousel_container ~384 tokens
  Create a draft carousel post with multiple images/videos before publishing. Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in under 24 hours, so publish promptly after creation. Bulk support: accepts ig_user_ids, location_ids for batched execution.
• instagram_get_conversation ~197 tokens
  Get details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will return permission errors. Newly sent/received messages may take a few seconds to appear in results. Bulk support: accepts c
• instagram_get_ig_media ~212 tokens
  Get a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engagement metrics, caption, media URLs, and metadata. NOTE: This action is for published media only. For unpublished containe
• instagram_get_ig_media_comments ~237 tokens
  Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Business/Creator account. Supports cursor-based pagination for navigating through large comment lists. An empty data array in t
• instagram_get_ig_media_insights ~219 tokens
  Read media insights. REST response: read result.result.data. Request metric=[views,reach,saved,shares] for views, reach, saves and shares; availability depends on the media type and metric. Bulk support: accepts ig_media_ids for batched execution.
• instagram_get_ig_user_media ~249 tokens
  List account media. REST response: read result.result.data and result.result.paging (not result.data). Null engagement fields mean unavailable, not zero; use media insights for saved, shares and views. Bulk support: accepts ig_user_ids, auto_resolve_fb_page_ids for batched execution.
• instagram_get_user_info ~197 tokens
  Get Instagram Business Account info including profile details and statistics. Use "me" to query your own authenticated account, or provide the numeric Business Account ID of an account you manage. NOTE: followers_count and follows_count are returned for your own profile (ig_user_id="me"). For other
• instagram_get_user_insights ~376 tokens
  Read account insights at result.result.data in REST. An empty data array means insights are unavailable, not zero. It does not by itself establish a follower-count restriction. Bulk support: accepts ig_user_ids for batched execution.
• instagram_list_all_conversations ~248 tokens
  List all Instagram DM conversations for the authenticated user. Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response conversations are nested under `data.data` — accessing top-level `data` as the final list returns zero items. An empty `dat
• instagram_list_all_messages ~213 tokens
  List all messages from a specific Instagram DM conversation. Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response data is nested under data.data (double-wrapped); attachment-only messages may have empty text fields. Bulk support: accept
• instagram_mark_seen ~234 tokens
  Mark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is visible to the other party and changes inbox read state — use with explicit user approval in automated or bulk flows. IM
• instagram_post_ig_comment_replies ~211 tokens
  Tool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300 characters or less, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters. Bulk support:
• instagram_post_ig_user_media ~471 tokens
  Tool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publishing process - after creating the container, use the media_publish endpoint to publish it. Bulk support: accepts ig_user
• instagram_post_ig_user_media_publish Sends messages · ~260 tokens
  Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Instagram enforces an account-specific content-publishing rate limit over a 24-hour moving window; the exact cap varies by account and should
• instagram_send_image Sends messages · ~196 tokens
  Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. Bulk support: accepts ig_user_ids, recipient_ids for batched execution.
• instagram_send_text_message Sends messages · ~280 tokens
  Send a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Creator account with messaging permissions. Fails with error_subcode 2534022 if outside the messaging window; do not retry

Browse

• GitHub tools
• Social media
• GitHub and code hosting
• Docker and Kubernetes
• Government and public data

Related MCP servers

• oriiion
  Your marketing, a message away
• ShearQuery — Barber & Beauty Industry Data
  Barber & cosmetology exam pass rates, booth rent with open chairs, and Texas licensee counts
• ScrapeField
  Google Maps, LinkedIn, Instagram, TikTok and X data as tools. Demo mode needs no key.
• Hermoso
  AI marketing agent and AI ad generator: 928 tools, usable alone. No markup on models.
• Sprkly
  Schedule, publish and track social posts across TikTok, Instagram, Threads and YouTube Shorts.
• Meta Ads (Facebook & Instagram)
  Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide
• Perkadoo
  Manage Perkadoo giveaways, streak programs and perks, plus verifiable draws and streak badges.
• Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
  Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.mcp-dir/instagram-mcp.svg)](https://aptlynx.net/servers/io.github.mcp-dir/instagram-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents