The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Instagram listing page.
Connect your own Instagram account to Claude, Cursor or your own agent. Through the official API: publish photos, videos, carousels, Reels and Stories, read and reply to comments, talk in DMs, and pull profile and media insights. With the Advanced plan the same account also likes posts, follows and unfollows, lists and views stories, and starts a DM conversation. Connect in 2 clicks (Business or Creator account) or with username and password, 2FA supported.
get_job_status, list_jobs)Versão em português · Full docs (PT-BR) · Agent skill
Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):
Manual (if the deeplink does not open): claude.ai/customize/connectors → + → Add custom connector → paste Name Instagram and URL https://api.mcp.ai/p_instagram.
➕ Install Instagram in VS Code
Works with any MCP client that speaks MCP over HTTP. The server URL is always:
Per-client details: INSTALL.md.
| Tool | Description |
|---|---|
instagram_actions_list_accounts | List the Instagram accounts connected to this install — id, username, label. |
instagram_actions_like | Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). |
instagram_actions_list_comments | List the comments on a post, addressed by URL or shortcode. |
instagram_actions_like_comment | 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 jo… |
instagram_actions_follow | Follow one or more Instagram users by @username. |
instagram_actions_unfollow | Unfollow one or more Instagram users by @username. |
instagram_actions_list_stories | List a specific user's currently available stories (read-only, does not mark as seen). |
instagram_actions_view_story | Watch (mark as seen) the stories of one or more profiles. |
instagram_actions_send_message | Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). |
instagram_actions_get_job_status | Get the status/progress/result of a previously started action by its job_id. |
instagram_actions_list_jobs | List recent action jobs for the connected account, optionally filtered by status. |
instagram_get_user_info | Get Instagram Business Account info including profile details and statistics. |
instagram_get_ig_user_media | Get Instagram user's media collection (posts, photos, videos, reels, carousels). |
instagram_get_ig_media | Get a published Instagram Media object (photo, video, story, reel, or carousel). |
instagram_get_ig_media_comments | Tool to retrieve comments on an Instagram media object. |
instagram_get_ig_media_insights | Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). |
instagram_get_user_insights | Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). |
instagram_post_ig_user_media | Tool to create a media container for Instagram posts. |
instagram_create_carousel_container | Create a draft carousel post with multiple images/videos before publishing. |
instagram_post_ig_user_media_publish | Tool to publish a media container to an Instagram Business account. |
instagram_post_ig_comment_replies | Tool to create a reply to an Instagram comment. |
instagram_send_text_message | Send a text message to an Instagram user via DM in an existing conversation. |
instagram_send_image | Send an image via Instagram DM to a specific user. |
instagram_mark_seen | Mark Instagram DM messages as read/seen for a specific user. |
instagram_get_conversation | Get details about a specific Instagram DM conversation (participants, etc). |
instagram_list_all_conversations | List all Instagram DM conversations for the authenticated user. |
instagram_list_all_messages | List all messages from a specific Instagram DM conversation. |
Details for each tool: docs/ferramentas.md (PT-BR)
Engagement actions are asynchronous and run one at a time. Each takes ~40 s to ~2 min and the queue is serial, so this MCP is built to operate your account at a human pace, not for volume. If you need reading/publishing at scale, use the Basic plan, which is synchronous and free.
Billed per connected account. See docs/precos.md (PT-BR).
What is the difference between the Basic and Advanced plans? Basic is free, connects in 2 clicks and uses the official Instagram API (publishing, comments, DMs, insights). Advanced is a subscription per connected account and adds, on that same account, liking, following, unfollowing, listing/viewing stories and starting a DM conversation. Advanced also includes everything in Basic.
Do I need a Business or Creator account? For the Basic plan yes, that is what the official API requires. The Advanced plan connects with username and password (2FA supported) and has no such requirement.
How many actions per minute? Engagement actions are queued and executed one at a time, ~40 s to 2 min each. This MCP does not sell volume or bulk sending. Reading and publishing through the official API do not go through that queue.
Does this touch other people's accounts? No. Every action happens on the account you connected, with your authorization, and each one returns an auditable job id. Use it within Instagram's Terms of Use.
How do I like a post?
Pass the post URL (https://www.instagram.com/p/… or /reel/…) or the shortcode. The numeric id the official API returns in id does not work for liking. If you listed media through the official side, use the permalink field.
Is there a REST API besides MCP? Yes. The same tool set is mirrored over REST with a Bearer token, with OpenAPI and a skill markdown you can paste into your own agent. See docs/api-rest.md.
Is the server open source? The server is proprietary (hosted). This repository is the public wrapper with manifests, docs and skills, all MIT.
MIT — see LICENSE. The MCP server at api.mcp.ai/p_instagram is proprietary (hosted); this repo (manifests, docs, skills) is MIT.