/instagram

name: instagram
description: Manage Instagram professional accounts via the Hyper MCP — publish photos, Reels, Stories, and carousels; moderate comments and mentions; send Direct Messages; pull account and media insights. Uses the Instagram API with Instagram Login (Business Login). Use when the user mentions Instagram posts, Reels, Stories, carousels, IG DMs, Instagram comments, mentions, profile, or analytics. For paid Instagram advertising, use `meta-ads`.
requires_toolkits:
  - instagram_toolkit
icon: instagram
short_description: Publish photos, Reels, Stories, and carousels, moderate comments, send DMs, and pull insights.

Instagram

Complete skill for managing Instagram professional accounts through the Instagram API with Instagram Login (Business Login). Covers content publishing, messaging, comment moderation, insights, and profile management.

Out of scope — defer to other skills

| Request | Send them to | | --- | --- | | Paid Instagram / Facebook ads, boosting a post, Advantage+ | `meta-ads` | | Competitor ad research from the Meta Ad Library | `meta-ads-library` | | TikTok publishing | `tiktok` | | LinkedIn document or carousel posts | `linkedin` |

Requirements

• **Hyper MCP installed and connected.** [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp)
• **Instagram integration connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps) — this skill uses the **Instagram API with Instagram Login** (NOT the older Instagram Graph API via Facebook Login).
• For organization posts to a company page, the connected account must have permission to post for that organization.

If `search("instagram_current_user_get")` does not find `instagram_current_user_get`, stop and tell the user to enable Hyper MCP and connect Instagram.

How to run the tools in this skill

Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:

| Surface | Find a tool | Run it | | --- | --- | --- | | MCP client (Claude, Cursor, Codex, ChatGPT) | `search("<what you want to do>")`, then `describe("<name>")` | `call("<name>", {...})` | | Hyper CLI | `hyperai search "<what you want to do>"`, then `hyperai describe <name>` | `hyperai call <name> --json '{...}'` |

If a tool is not found, its integration is not connected or not enabled for the workspace: stop and tell the user which integration to connect.

Tool surface

| Tool group | Tools | | --- | --- | | Account | `instagram_current_user_get`, `instagram_users_get` *(look up any public IG profile by username or ID — useful for researching commenters and DM contacts)* | | Publishing | `instagram_photo_containers_create`, `instagram_reel_containers_create`, `instagram_carousel_containers_create`, `instagram_container_status_check`, `instagram_media_publish`, `instagram_publishing_limits_check` | | Media library | `instagram_media_list`, `instagram_media_get`, `instagram_album_children_get`, `instagram_stories_list`, `instagram_tagged_media_get` | | Comments | `instagram_comments_list`, `instagram_comments_send`, `instagram_comments_reply`, `instagram_comments_hide`, `instagram_comments_delete`, `instagram_comments_toggle` | | Direct Messages | `instagram_conversations_list`, `instagram_conversation_messages_get`, `instagram_messages_get`, `instagram_messages_send`, `instagram_media_messages_send`, `instagram_post_messages_send`, `instagram_messages_react` | | Insights | `instagram_account_insights_get`, `instagram_media_insights_get` |

Critical Rules

> **CRITICAL**: This toolkit uses the **Instagram API with Instagram Login** (not the older Instagram Graph API via Facebook Login). Metric names and available fields differ from the older API. Always use the metric names documented in this skill.

> **CRITICAL**: The `engagement` metric does NOT exist in this API. Use individual metrics like `likes`, `comments`, `shares`, `total_interactions` instead.

> **CRITICAL**: The `impressions` metric is NOT valid for account-level insights. Use `reach` or `views` instead.

> **CRITICAL**: Content publishing uses a two-step container workflow: (1) create a media container, (2) publish it. For video content, poll the container status until `FINISHED` before publishing.

> **CRITICAL**: Instagram DM responses must be sent within 24 hours of the user's last message (standard messaging window). The Human Agent tag extends this to 7 days if approved.

> **IMPORTANT**: Publishing rate limit is 100 API-published posts per 24-hour rolling window. Carousels count as 1 post. Always call `instagram_publishing_limits_check` before bulk publishing.

> **CRITICAL**: Do NOT use the `location_id` parameter on photo, reel, or carousel containers unless the user explicitly provides a verified Facebook Page ID. This integration uses Instagram Business Login which cannot look up or validate location IDs. Passing an invalid or guessed ID will cause a 400 error (`Param location_id is not a valid location page ID`). If a user asks for location tagging, explain that they need to provide their Facebook Page ID with location data.

> **CRITICAL**: When passing media URLs (`image_url`, `video_url`, `cover_url`, `media_url`) to any Instagram tool, use the URL **exactly as returned** by the source tool — most commonly the `url` field from `read_file` or `display_file`. Do NOT: > - Reconstruct or shorten the URL. > - Drop, change, or invent any query parameters (signatures, timestamps, etc.). > - Substitute a different host. > - Copy a URL from memory or transcribe it character-by-character — call `read_file` again instead. > > Hyper-hosted CDN URLs are automatically resized and re-signed for Meta when needed, so just hand them through verbatim. A single-character corruption in a presigned signature causes Meta to return a misleading `9004 / 2207052: Only photo or video can be accepted as media type` error.

> **IMPORTANT**: Most tools act on the authenticated account automatically — you do NOT need to pass