Instagram

Your Instagram account in Claude, Cursor and AI agents: publish, reply and measure

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.

• 📸 Really publishes: photos, videos, carousels, Reels and Stories through the official API
• 💬 Comments and DMs: read, reply, mark as seen and list conversations
• 📈 Profile and media insights: reach, impressions, engagement
• ❤️ Engagement on your own account (Advanced plan): like a post, like a comment, follow, unfollow, list and view stories, start a DM conversation
• 🔑 Two ways to connect: 2 clicks (Business/Creator) or username and password with 2FA
• 🧾 Async actions with a job id: track every action's state (get_job_status, list_jobs)
• 🌐 Mirrored REST API for your own backend, on top of MCP
• 💬 Works with any MCP client: Claude Desktop, Cursor, VS Code, Cline, Continue

Versão em português · Full docs (PT-BR) · Agent skill

---

One-click install

Claude (Web and Desktop)

Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):

➕ Open in Claude and connect

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.

Cursor

➕ Install Instagram in Cursor

VS Code (Copilot Chat)

➕ Install Instagram in VS Code

ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks MCP over HTTP. The server URL is always:

https://api.mcp.ai/p_instagram

Per-client details: INSTALL.md.

---

Example prompts

Publish this image on my Instagram with the caption "today's launch"
Which new comments came in on my last 3 posts?
Reply to that comment thanking them
What was the reach of my Reels last week?
Like this post: https://www.instagram.com/p/CxAbCdEfGhI/
Follow the profile nasa from my account

---

27 tools available

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)

---

How it works

1. Install the MCP in your client (Claude / Cursor / VS Code)
2. Connect YOUR account:
   • Basic    — 2 clicks, Business or Creator account (official API)
   • Advanced — username and password, 2FA supported
3. Reading and publishing answer immediately (official API)
4. Engagement actions are queued and return a job id
5. instagram_actions_get_job_status follows each action to the end

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.

---

Pricing

Billed per connected account. See docs/precos.md (PT-BR).

---

Privacy & data protection

• Sub-processors: the LLM host you choose (Claude, ChatGPT, Cursor, your own agent). Full list in docs/privacidade-lgpd.md.
• Data returned by the tools is sent to the LLM host you choose, a sub-processor outside our control. We recommend plans with training opt-out.

---

FAQ

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.

---

Support

• 📧 instagram@mcp.ai
• 🐛 GitHub Issues
• 📄 docs/

---

License

MIT — see LICENSE. The MCP server at api.mcp.ai/p_instagram is proprietary (hosted); this repo (manifests, docs, skills) is MIT.