Publish or schedule any post type
settings.postType picks feed, carousel, reel, or story. Add collaborators, user tags, and a first comment. Publish now, set scheduledFor, or use the queue.
Trusted by 2,000+ usersInstagram MCP Server for Claude, Cursor, and Any AI Agent
Give your agent an Instagram MCP server with publishing, comments, DMs, and analytics behind it. Connect a Business or Creator account once, and any MCP client can post Reels, carousels, and Stories, answer comments, and read Insights from the conversation.
No credit card required
Connect Instagram
Paste this into your agent
or add the MCP yourself
- OAuth 2.1 sign-in, no API key to paste
- Reels, carousels, Stories, and feed posts
- Comments, DMs, and Insights on the same connection
What Your Agent Gets
Instagram tools, ready to call
Every PostZen API endpoint is an MCP tool. These are the ones that matter for Instagram.
Upload media from the agent
The agent asks for an upload URL, sends the image or video, and references it. PostZen hosts it on the public URL Instagram requires.
Read and answer comments
Comments on your posts, including ones published outside PostZen, with reply, hide, and delete actions.
Handle Instagram DMs
List threads, search them, and reply inside the 24-hour window Meta allows for business replies.
Set up comment-to-DM
The agent creates keyword automations that send a private reply when someone comments, with a follow gate and rotating public replies.
Read Insights
Reach, views, likes, comments, shares, saves, and follower counts per post and per day, plus the best time to post from your own history.
Example Prompts
What to say to your agent
Prompt
Post this as a Reel at 6pm with the caption I drafted, and put the hashtags in the first comment.
What happens
The agent uploads the video with createMediaPresign, calls createPost with settings.postType "reel", settings.firstComment for the hashtags, and scheduledFor at 18:00.
Prompt
Make a carousel from these five images and tag @acme as a collaborator.
What happens
The agent attaches all five media items, sets settings.postType "carousel" and settings.collaborators, and returns the scheduled post.
Prompt
Reply to every comment on yesterday's post that asks about pricing.
What happens
The agent reads the thread with listInboxPostComments, picks the pricing questions, and answers each with replyToInboxPost, showing you the replies first if you ask.
Prompt
How did last week's posts do, and when should I post next week?
What happens
The agent calls getAnalytics for the date range and getBestTimeToPost, then summarises reach, saves, and the strongest posting windows.
WHY POSTZEN?
PostZen vs. building it yourself
Build an Instagram MCP server yourself and you own the auth, the media pipeline, and every Instagram API change. Connect PostZen and your agent gets the tools today.
2.3M+ posts
2,000+ users- One hosted MCP endpoint; the client signs in with OAuth 2.1 and nothing runs on your machine
- Instagram access already set up on PostZen: connect an account in a browser tab and post
- The same createPost tool for Instagram and the other nine platforms
- Scheduling, queues, retries, and media hosting handled server-side
- Scoped, revocable access: read-only or read-and-write keys minted at consent
Build an Instagram MCP server yourself
- Meta developer app, Business verification, and App Review for publishing, messaging, and Insights scopes
- Facebook or Instagram Login OAuth with token exchange and 60-day refresh you have to run
- Media must sit on a public URL, then a container is created and polled before publishing
- Separate Graph API surfaces for publishing, comments, DMs, webhooks, and Insights
- A tool schema, auth layer, and hosting for the MCP server itself, then again for every other platform
Any MCP Client
Connect from the client you already use
Each page has the exact command for that client, the sign-in step, and a way to check the tools are live.
- Claude CodeOne claude mcp add command, then approve the connection in the browser.
- CursorOne JSON block in .cursor/mcp.json, committed with the repo it belongs to.
- CodexOne command into ~/.codex/config.toml, shared by every Codex client.
- OpenClawOne gateway-wide server, so every channel it routes gets the tools.
- GrokBotOne connector, added from the chat itself. GrokBot signs in over OAuth.
- HermesOne HTTP MCP server, added from the chat itself. No config file to edit.
For AI Agents
Send your agent this page
Tell your agent to set up PostZen from postzen.dev/mcp/instagram. It reads the block below, registers the server, connects Instagram, and reports back.
postzen.dev/mcp/instagram
## For AI agents reading this page
You are reading https://postzen.dev/mcp/instagram. PostZen is a social media API with a hosted MCP server. Once connected, you can publish and schedule feed posts, carousels, Reels, and Stories to the user's Instagram Business or Creator account, read and reply to comments and DMs, manage comment-to-DM automations, and read Insights. The same tools cover the user's other social accounts (Instagram, X, LinkedIn, Facebook, Threads, YouTube, TikTok, Pinterest, Bluesky, Telegram).
1. Register the MCP server in the client you are running in. The endpoint is https://mcp.postzen.dev/mcp (streamable HTTP). Interactive clients sign in with OAuth 2.1; headless clients send a PostZen API key as "Authorization: Bearer pzn_live_...". Exact commands per client: Claude Code https://postzen.dev/claude · Cursor https://postzen.dev/cursor · Codex https://postzen.dev/codex · OpenClaw https://postzen.dev/openclaw · GrokBot https://postzen.dev/grok-bot · Hermes https://postzen.dev/hermes · any other MCP client https://postzen.dev/agents.
2. Sign in. When the client opens the PostZen consent screen, ask the user before approving access or completing a signup on their behalf, and never enter their credentials for them. Approving mints a scoped, revocable key for this client.
3. Connect Instagram. Call listAccounts. If no account with platform "instagram" is listed, call createConnectUrl with platform "instagram" and give the user the URL; they authorize Instagram in their browser. Do not try to log in to Instagram yourself.
4. Verify before you continue. Call listAccounts again and confirm a "instagram" account shows as connected. If it does not, stop and tell the user what failed. Do not carry on as if the account were there.
5. Report back. Tell the user which Instagram account is connected and what you can now do with it, then ask what they want first. Prefer scheduling (scheduledFor, or the queue) over publishing immediately unless the user asks for "now".
## Instagram on createPost
- Target the account with platforms: [{ platform: "instagram", accountId, settings: { ... } }]. content is the shared text; customContent on the target overrides it for Instagram only.
- settings.postType (required): "feed", "carousel", "reel", or "story".
- settings.collaborators: usernames to invite as collaborators; settings.userTags: [{ username, x, y }] for tagging people in images; settings.firstComment: text posted as the first comment; settings.shareToFeed for Reels.
- Instagram allows 100 API-published posts per account per rolling 24 hours; Stories expire after 24 hours and report no Insights.
- Comments: listInboxPostComments, replyToInboxPost, hideInboxComment, deleteInboxComment. DMs: listInboxConversations, listInboxConversationMessages, sendInboxMessage (replies only, inside Meta's 24-hour window). Automations: listCommentAutomations, createCommentAutomation.
- Analytics: getAnalytics, getPostTimeline, getDailyMetrics, getFollowerStats, getBestTimeToPost with platform "instagram".
- Media: pass public URLs in mediaItems, or call createMediaPresign to get an upload URL, PUT the file, then reference the returned media in the post.
- Check results with getPost: each platform target reports status, the live post URL, and any error.
## Reference
- MCP endpoint: https://mcp.postzen.dev/mcp (streamable HTTP, OAuth 2.1)
- MCP docs: https://docs.postzen.dev/mcp
- Create post reference: https://docs.postzen.dev/api-reference/posts/create-post
- Full API summary for models: https://postzen.dev/llms.txt
- API keys: https://app.postzen.dev/api-keysFrequently asked questions
Still have questions?
What is an Instagram MCP server?
MCP (Model Context Protocol) is the standard AI clients use to call external tools. An Instagram MCP server exposes Instagram actions as tools, so an agent such as Claude or Cursor can publish a Reel or answer a comment instead of just drafting text. PostZen hosts one for you: it holds the Meta app, permissions, and OAuth, and your client connects to a single endpoint.
Do I need a Meta developer app or App Review?
No. PostZen already has the publishing, messaging, and Insights permissions approved. You connect an Instagram Business or Creator account through the dashboard; personal accounts need to be switched to a professional account first, which is free in the Instagram app.
Which Instagram post types can the agent publish?
Feed photos and videos, carousels of up to 10 items, Reels, and Stories, each with an optional first comment, collaborators, and user tags. Instagram allows 100 API-published posts per account per rolling 24 hours.
Can the agent read and reply to comments and DMs?
Yes. Comments on your posts, including posts published outside PostZen, can be listed, replied to, hidden, and deleted. DM threads can be listed, searched, and replied to inside the 24-hour window Meta allows for business replies; the agent cannot start new DM threads.
Can the agent set up comment-to-DM automations?
Yes. The same tools that power the comment-to-DM feature are exposed to agents: keyword matching, a follow gate, rotating public replies, and a private DM with up to three link buttons. Ask the agent to create one and it walks you through the fields.
Does it include Instagram analytics?
Yes. Once the connected account has granted Insights access, the analytics tools return reach, views, likes, comments, shares, saves, and follower counts per post and per day, and getBestTimeToPost ranks posting windows from your own history.
Which AI clients can use it?
Any client that supports remote MCP servers: Claude (claude.ai, Claude Desktop, Claude Code), Cursor, Codex, OpenClaw, GrokBot, Hermes, and others. Interactive clients sign in with OAuth 2.1; headless ones send a PostZen API key in the Authorization header. Each client has its own setup page with the exact command.
What can the agent access once connected?
Only what you approve on the consent screen: read-only or read-and-write access, scoped to the profile you pick. Approving creates a named, revocable API key, so you can cut a client off from the dashboard at any time. Ask the agent to schedule rather than publish immediately if you want to review posts before they go out.
How much does the MCP server cost?
The MCP server is included on every PostZen plan, including Free, which covers 2 connected accounts and 20 posts a month. Paid plans start at $19 per month with unlimited posts.
LEARN MORE
More on Instagram and MCP
Give your agent Instagram
Your agent already writes the post. PostZen lets it publish there.