# Instagram

MCP server for Instagram Graph API — publish photos, reels, carousels, and stories, manage comments, view insights, and search hashtags through 25 tools.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add node2flow/instagram

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/instagram

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/instagram ig_get_account

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/instagram ig_get_account '{}'
```

## Direct MCP Connection

Endpoint: `https://instagram--node2flow.run.tools`

**Required config:**
- `INSTAGRAM_ACCESS_TOKEN` (query) — Instagram/Facebook User Access Token with instagram_* permissions

**Optional config:**
- `INSTAGRAM_ACCOUNT_ID` (query) — Instagram Business Account ID (optional — auto-detected from token)

## Tools (22)

- `ig_get_account` — Get Instagram Business/Creator account info: username, name, bio, followers, following, media count, profile picture, a…
- `ig_get_account_insights` — Get account-level analytics. Metrics: impressions, reach, follower_count, email_contacts, phone_call_clicks, text_messa…
- `ig_list_media` — List media posts from an Instagram account. Returns ID, caption, type (IMAGE/VIDEO/CAROUSEL_ALBUM), URL, permalink, tim…
- `ig_publish_photo` — Publish a photo post to Instagram. Requires a public image URL. Handles the 2-step process (create container → publish)…
- `ig_publish_carousel` — Publish a carousel post (multiple images/videos) to Instagram. Provide 2-10 media URLs. Each item can be an image or vi…
- `ig_publish_reel` — Publish a Reel (short video) to Instagram. Video must be publicly accessible. Supports cover image and share-to-feed op…
- `ig_publish_story` — Publish a Story (image or video) to Instagram. Stories disappear after 24 hours.
- `ig_get_media` — Get details of a single Instagram media post: caption, type, URL, permalink, timestamp, likes, and comments count.
- `ig_get_media_insights` — Get analytics for a specific media post. Image/Carousel metrics: impressions, reach, engagement, saved. Video/Reel metr…
- `ig_get_children` — Get individual items from a carousel post. Returns each child media with ID, type, and URL.
- `ig_list_comments` — List comments on an Instagram media post. Returns comment ID, text, username, timestamp, like count, and hidden status.
- `ig_get_comment` — Get a single comment with its replies. Returns comment text, author, timestamp, like count, and threaded replies.
- `ig_reply_comment` — Reply to an Instagram comment. Creates a threaded reply under the comment.
- `ig_delete_comment` — Permanently delete a comment from an Instagram post.
- `ig_hide_comment` — Hide or unhide a comment. Hidden comments are only visible to the commenter.
- `ig_list_stories` — List currently active Stories on the account. Stories disappear after 24 hours.
- `ig_get_story_insights` — Get insights for a specific Story. Metrics: impressions, reach, replies, taps_forward, taps_back, exits.
- `ig_search_hashtag` — Search for a hashtag by name and get its ID. Use the returned ID with ig_get_hashtag_recent or ig_get_hashtag_top. Limi…
- `ig_get_hashtag_recent` — Get recent media posts for a hashtag. Returns public posts from the last 24 hours. Use ig_search_hashtag first to get t…
- `ig_get_hashtag_top` — Get top (most popular) media posts for a hashtag. Returns the most engaged public posts. Use ig_search_hashtag first to…
- `ig_list_tags` — List media posts where the account has been tagged (photo tags, not @mentions). Returns post details.
- `ig_get_mentioned_media` — Get details of a media post where the account was @mentioned in a caption. Requires the mentioned_media_id from a webho…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get node2flow/instagram <tool-name>
```

## Resources

- `instagram://server-info` — Connection status and available tools for this Instagram MCP server

## Prompts (2)

- `content-publishing` — Guide for publishing photos, carousels, reels, and stories to Instagram
- `analytics-guide` — Guide for viewing Instagram account and media insights

---

License: MIT