Instagram as an MCP

Instagram is a social media platform for sharing photos and videos. As an MCP, agents can read engagement insights, list published media and comments, moderate comments, and publish new posts, carousels, or reels to your professional (Business or Creator) accounts.

	Available
Nekt Express	Yes
GCP	Yes
AWS	Yes

Adding Instagram as an MCP

Before you start, make sure the MCP Server is set up. See MCPs for how MCPs work.

Go to Activate → MCPs, click New MCP and choose Instagram.
Name your MCP and describe what it is used for. The agent reads the description to choose between MCPs of the same provider.
Setup access. Click the sign-in button and authorize with a Meta account that can see the data you want the agent to use. Actions run with that account’s permissions.
- Sign in with Meta: Sign in with a Meta account that has access to the Facebook Pages linked to the Instagram professional (Business/Creator) accounts you want to read from and publish to. (Required)
Select tools. Pick the tools your agents can use. See Available tools below.
Click Save. On Growth and Custom plans, choose who can use it; see Access levels.

Example prompts

“Publish a new photo to our main Instagram account using this image URL and the caption ‘Exciting news coming soon!’.”
“What were our top-performing reels by total interactions over the last 30 days?”
“Check our current API publishing quota to see if we have room for another post today.”
“List the recent comments on our latest carousel post and hide any that contain spam keywords.”
“Get the follower count and profile views from the last week for our professional account.”

Available tools

Choose which of these tools your agents can use in Select tools.

Read tools

Tool	Description	Parameters
`get_account_insights`	Get account-level Instagram insights (reach, views, profile views, accounts engaged, total interactions) for a date range (YYYY-MM-DD, defaults to the last 30 days on Meta’s side); metrics accepts a custom comma-separated metric list.	`ig_user_id` (string, required), `metrics` (string), `end_date` (string), `start_date` (string)
`get_account_profile`	Get an Instagram professional account’s profile: username, name, biography, website, followers/following and media counts.	`ig_user_id` (string, required)
`get_media_insights`	Get engagement metrics for one Instagram media: reach, likes, comments, saves, shares, views and total interactions. media_product_type: FEED (posts/carousels), REELS or STORY — story insights are only available for 24h.	`media_id` (string, required), `media_product_type` (string)
`get_publishing_limit`	Get how many API-published posts the Instagram account has used of its rolling 24h publishing quota.	`ig_user_id` (string, required)
`list_comments`	List comments on an Instagram media with author username, text, timestamp, like count, hidden flag and replies.	`media_id` (string, required), `limit` (integer)
`list_instagram_accounts`	List the Instagram professional accounts accessible to the authenticated user, with the IG user id (used by every other tool), username, followers and the linked Facebook page.	—
`list_media`	List an Instagram account’s published media (posts, carousels and reels) with caption, type, permalink, timestamp and like/comment counts; since filters by creation date (YYYY-MM-DD).	`ig_user_id` (string, required), `limit` (integer), `since` (string)
`list_stories`	List an Instagram account’s currently active stories (last 24h) with media type, URL and timestamp.	`ig_user_id` (string, required)

Write tools

Tool	Description	Parameters
`delete_media`	Permanently delete a published Instagram media: post, reel, story or an entire carousel album (individual carousel items cannot be deleted; ad posts are not supported).	`media_id` (string, required)
`moderate_comment`	Moderate a comment on an Instagram media. action: hide, unhide or delete (delete is permanent).	`action` (string, required), `comment_id` (string, required)
`publish_carousel`	Publish a carousel post (2-10 images) to an Instagram professional account’s feed. Each URL must be a publicly accessible JPEG; the caption cannot be edited after publishing.	`ig_user_id` (string, required), `image_urls` (array, required), `caption` (string)
`publish_photo`	Publish a single photo to an Instagram professional account’s feed. image_url must be a publicly accessible JPEG; the caption cannot be edited after publishing.	`image_url` (string, required), `ig_user_id` (string, required), `caption` (string), `alt_text` (string)
`publish_reel`	Publish a reel to an Instagram professional account. video_url must be a publicly accessible MP4/MOV (Meta processes it asynchronously — this tool waits up to ~2min); the caption cannot be edited after publishing.	`video_url` (string, required), `ig_user_id` (string, required), `caption` (string), `cover_url` (string), `share_to_feed` (boolean)
`reply_to_comment`	Reply to a comment on an Instagram media as the account owner.	`message` (string, required), `comment_id` (string, required)
`update_media`	Enable or disable comments on a published Instagram media (the only supported update on published media — captions cannot be edited via the API).	`media_id` (string, required), `comment_enabled` (boolean, required)

Troubleshooting

Expired or revoked access: If your Meta session expires or the app’s access is revoked, the MCP will show that it needs to reconnect. Go to the MCP’s page and sign in again.
Missing accounts: Standard Instagram accounts are not supported. The Meta account used for authorization must have access to the Facebook Page linked to an Instagram professional (Business or Creator) account.
Publishing limitations: The Instagram API does not allow editing captions after a post is published. Any media URLs provided to the agent for publishing must be publicly accessible.
Reel processing delays: Reels are processed asynchronously by Meta. If the agent publishes a reel, it may take up to a few minutes for the API to confirm the post.
Rate limits: API-published posts count against a rolling 24-hour quota per account. The agent can check your remaining quota if needed.

Need help?

Contact our support team if you have trouble connecting Instagram.

Documentation

Get started

Context

Activate

Workspace

Resources

Instagram as an MCP

Adding Instagram as an MCP

Example prompts

Available tools

Read tools

Write tools

Troubleshooting

Need help?

​Adding Instagram as an MCP

​Example prompts

​Available tools

​Read tools

​Write tools

​Troubleshooting

​Need help?

Adding Instagram as an MCP

Example prompts

Available tools

Read tools

Write tools

Troubleshooting

Need help?