/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 `instagram_current_user_get` is not found, the integration to connect is 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 | | --- | --- | --- | | Hyper chat | Call the tool by its name; `search_tools(queries=["<provider> <action>"])` shows its parameters | `<name>(...)` | | MCP client (Claude, Cursor, Codex, ChatGPT) | `search("<what you want to do>")`, then `describe("<name>")` | `call_read("<name>", {...})`, `call_write` or `call_destructive`: the one that `describe` names in `call_with` | | Hyper CLI | `hyperai search "<what you want to do>"`, then `hyperai describe <name>` | `hyperai call <name> --json '{...}'` |

If a tool is not found: in Hyper chat, find its toolkit id with `discover_toolkits` and pass it to `enable_toolkit`. On an MCP client or the CLI, tell the user which integration to connect in Hyper.

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 cause