Instagram

Instagram MCP: setup guide and options

An Instagram MCP server connects your agent to Instagram data: profiles, posts, reels, comments and hashtag search. This guide covers your options, setup in Claude, ChatGPT and Cursor, and when a hosted alternative fits better.

Jesse Sibley
By , FounderPublished · Last updated · 12 min read

An Instagram MCP server connects an AI agent such as Claude, ChatGPT or Cursor to Instagram data: profiles, posts, reels, comments and hashtag search. The quickest route is a hosted server. Manifold is hosted, so there is no Instagram login, Meta developer app or API key of your own to set up. You pay per call, and every workspace starts with 500 free credits.

This guide explains what an Instagram MCP server does, compares your options, walks through setup in Claude, ChatGPT and Cursor, and lists the Instagram tools, example prompts and common questions.

What is an Instagram MCP server?

MCP (Model Context Protocol) is the open standard AI clients use to call outside tools. An Instagram MCP server exposes Instagram as a set of tools your agent can call: get a profile, list posts or reels, search posts by hashtag, read comments and pull a reel's transcript. You ask a question in plain words, the agent picks the calls, reads the results and replies with a summary.

People use an Instagram MCP server to:

  • Research competitor content: what they post, how often and which posts do best
  • Size up a creator or brand before a partnership or outreach
  • Track posts under a hashtag or a branded tag
  • Mine comments for sentiment, questions and complaints
  • Pull a reel's transcript without watching it

Your options: open source, hosted or Meta's Graph API

There are three kinds of Instagram tool. Pick by what you want to reach and whether you want to manage access yourself.

Open-source servers

Most GitHub results for "Instagram MCP server" are self-hosted servers you run yourself. Some are built on Meta's official Instagram API for Business and Creator accounts you manage. Others log in to Instagram's private API with a username and password, which reads any public account but risks restrictions. A few examples:

  • William-Gao/instagram-mcp (Python, MIT). Uses Meta's Instagram API with Instagram Login, so no Facebook Page is needed for the core tools. More than 25 tools for profile, media, publishing, comments, insights and DMs. Add a Facebook Page token and it can also look up other Business or Creator accounts and search hashtags. DMs need Meta's App Review.
  • adelaidasofia/instagram-mcp (Python, FastMCP, MIT). Official Instagram Graph API for Business or Creator accounts linked to a Facebook Page. 29 tools for accounts, media, publishing, insights, comments, hashtag and account discovery, and DMs that need App Review. Runs many accounts from one server.
  • anand-kamble/mcp-instagram (TypeScript, MIT). Logs in with your Instagram username and password. Searches accounts, reads profiles, posts, stories, comments and your home feed, and can like, comment and follow. Its README warns that your account can be restricted or suspended.

A local setup in Claude Desktop is a few lines in claude_desktop_config.json. For anand-kamble/mcp-instagram it looks like this:

JSON
{
  "mcpServers": {
    "mcp-instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram"],
      "env": {
        "IG_USERNAME": "your_instagram_username",
        "IG_PASSWORD": "your_instagram_password"
      }
    }
  }
}

Self-hosting is free and gives you full control, with trade-offs:

  • Meta's API is built around your own accounts. It works on Instagram Business or Creator accounts you manage, through a Meta app you register. Looking up other accounts or hashtags needs the Facebook Graph API path, which means a linked Facebook Page, and it only covers Business or Creator accounts.
  • Unofficial APIs risk restrictions. Servers that log in with your username and password drive Instagram's private APIs. Instagram's Terms of Use prohibit this, and accounts doing it can be restricted or banned.
  • Local servers stay local. A server that runs over stdio works in desktop clients on your machine, not in Claude on the web, on your phone or in ChatGPT, unless you host it behind a public URL yourself.
  • You maintain it. Updates and breakages when Instagram changes are yours to handle.

Hosted servers for publishing

A few hosted servers use Meta's official API to publish posts, Reels and Stories on your own Instagram Business or Creator account:

  • Blotato at https://mcp.blotato.com/mcp. Publishing, scheduling, analytics, comments and DMs on Instagram, plus eight other platforms. Starter is $29/mo with 20 social accounts and a 7-day free trial.
  • Outstand at https://mcp.outstand.so/mcp. Publishes photos, Reels, carousels and Stories, reads post and account metrics, and replies to comments on posts it published. Connects through Meta's OAuth. $19/mo with 3,000 posts, across 12 platforms.

These servers let you publish to your own account from your agent. They do not research public accounts you do not own.

Hosted servers for research

A hosted server runs in the cloud. You paste one URL into your client, and nothing runs on your machine. A few read public Instagram data:

  • HasData at https://mcp.hasdata.com/mcp?apis=instagram, with a HasData API key in a header. Three tools: a public profile, an account's post feed, and the comments on one post. 10 credits a call, with 1,000 free credits a month (100 calls) and paid plans from $59/mo.
  • Instapi at https://instapi.co/mcp, with an Instapi API key. Three data tools: search users, hashtags and places, get a profile, and list an account's recent posts, with images and videos described as text. 10 free credits, then $1 per 100 credits, at 1 credit a call.
  • Manifold reads public profiles, posts, reels, comments, hashtags and reel transcripts. There is no Instagram login, no Meta app to register and no API keys of your own. You pay per call: 500 free credits per workspace to start, then top-ups from $10 or Pro from $20/mo. It works in Claude on the web, desktop and mobile, ChatGPT, Cursor, Claude Code and any other client that supports remote MCP servers. The same server also covers SEO, AI answers, Reddit, other social platforms, ad libraries and leads, so your agent can check Instagram and, say, what your competitors post on TikTok in one conversation.

Meta's official ads MCP

Meta publishes an ads MCP server at https://mcp.facebook.com/ads, documented at developers.facebook.com. This server manages your own Meta ad account: reporting, campaigns, catalogs and tests. Its documentation lists no tools for reading public Instagram profiles or posts, so for Instagram content research you need a third-party server.

Compared

Open-source, official APIOpen-source, unofficialHosted publishersManifold (hosted research)
SetupInstall locally, register a Meta app, get an access tokenInstall locally, give it your Instagram loginPaste one URL and sign inPaste one URL and sign in
Uses your Instagram accountYes, a Business or Creator account through your Meta appYes, your username and passwordYes, connected through Meta's OAuthNo
Whose data it readsYour own accounts, plus other Business or Creator accounts with a Facebook Page tokenAny public accountYour own accountsAny public account
Publishing, comments and DMsYes (DMs need Meta's App Review)Comments, likes and followsYes, that is what they are forNo, your agent drafts and you post
Reel transcriptsNoNoNoYes
ClientsDesktop clients on your machineDesktop clients on your machineClaude (web, desktop, mobile), ChatGPT, Cursor, Claude Code and other remote MCP clientsClaude (web, desktop, mobile), ChatGPT, Cursor, Claude Code and other remote MCP clients
CostFree software, plus your own timeFree software, plus your own time$29/mo (Blotato), $19/mo (Outstand)500 free credits per workspace, then pay per call
Other data in the same serverInstagram onlyInstagram onlyPublishing across platformsSEO, AI answers, Reddit, other social, ad libraries and leads
Best forManaging your own Instagram Business or Creator accountDevelopers who accept the account riskSocial media managers who post and scheduleAnyone who needs public Instagram data in their agent, in any client

Set up an Instagram MCP server with Manifold

You need a Manifold account, which your client creates for you the first time you sign in. The server URL is the same in every client:

TEXT
https://mcp.manifoldmcp.com/mcp

Claude

  1. In Claude on the web or in the desktop app, open Settings → Connectors.
  2. Choose Add custom connector. Name it Manifold and paste the server URL.
  3. Choose Connect, then sign in to Manifold in the window that opens and approve Claude.
  4. Start a chat, check that Manifold is on in the chat's tools menu, and ask an Instagram question.

A connector you add on the web is also there in the desktop app and on your phone. In Claude Code, run claude mcp add --transport http manifold https://mcp.manifoldmcp.com/mcp, then /mcp to sign in. Full steps are in the Claude guide and the Claude Code guide.

ChatGPT

  1. In ChatGPT on the web, open Settings → Security and login and turn on Developer mode. ChatGPT needs it to add an MCP server by URL.
  2. Go to chatgpt.com/plugins, click Add at the top right, then choose Create MCP app.
  3. Name it Manifold and paste the server URL under Connection. Leave Authentication on OAuth.
  4. Tick I understand and want to continue, then choose Create. Sign in to Manifold when ChatGPT asks.
  5. In a chat, type @Manifold or pick it from + → More, and ask an Instagram question.

On a Business workspace only an admin can use developer mode, so ask them to add Manifold under Workspace settings → Apps → Create. See the ChatGPT guide.

Cursor

  1. Open Cursor Settings → MCP, add a server and paste the URL, or use Add to Cursor on the Cursor guide.
  2. Cursor lists Manifold. Choose it to sign in, and approve Cursor in the browser.
  3. Ask an Instagram question in the agent chat.

To share the server with everyone on a project, add it to .cursor/mcp.json:

JSON
{
  "mcpServers": {
    "manifold": { "url": "https://mcp.manifoldmcp.com/mcp" }
  }
}

Other clients

Codex, Gemini CLI, Grok and other clients are covered in the client guides.

What you can do with Manifold's Instagram tools

Your agent picks the tools for you, but knowing what each does helps you ask better questions.

ToolWhat it does
instagram_get_profileOne account: followers, following, post count, bio, verified, website and whether it is a business account
instagram_get_postsThe posts on one account, newest first, with likes, comments, shares and views where Instagram publishes them
instagram_get_reelsThe reels on one account, newest first, with the same engagement numbers
instagram_get_postOne post or reel in full: caption, engagement, media, length and whether it is an ad
instagram_get_commentsThe comments on one post or reel, with their likes, and replies when you ask for them
instagram_search_postsPosts under one hashtag, ranked by Instagram, from the past day up to all time
instagram_get_transcriptWhat is said out loud in one reel up to two minutes long, as text

A few things worth knowing:

  • Hashtag search only. Instagram does not offer free-text search across all posts, so instagram_search_posts searches by hashtag. If Instagram has no way to answer a question, there is no tool for it.
  • Repeat calls cost less. Most results are cached for hours, and a repeat of a call your workspace already paid for is free until the cache expires.
  • You see the price first. Every result reports what it cost, max_credits caps what a call can spend, and dry_run prices a call for free.
  • Your agent does the reading. It finds and reads accounts, posts and comments, reports back and drafts captions or replies if you ask. You decide what to post.

For parameters and result fields, see the Instagram tools docs.

Example prompts

Paste any of these into Claude, ChatGPT or Cursor once Manifold is connected.

Creator research. "Compare these five creators on follower count, post cadence, average engagement and whether they are business accounts. [handles]"

Hashtag monitoring. "Show me the top 20 posts under #veganrecipes from the last month and which accounts posted them."

Content analysis. "What are the ten most-liked reels on this brand's account this quarter, and what do they have in common? [handle]"

Comment mining. "Read the comments on our competitor's latest launch post and group them by sentiment, with quotes and links."

Reel transcripts. "Pull the transcripts of these five reels and list the claims they make. [reel URLs]"

Competitor tracking. "Which of our competitors posted in the last week, and what did they post about? [handles]"

Run this in your agent

Connect Manifold to Claude, ChatGPT or Cursor, then paste this prompt.

Compare these five creators on follower count, post cadence and engagement. Then check which hashtags they use most and pull the transcripts of their top three reels.

Where to go next

To compare other Instagram MCP servers, see Instagram MCP. To track what AI engines say about your category, pair these tools with AI visibility. For other social platforms, see Reddit MCP, TikTok MCP and LinkedIn MCP. For plans, see pricing.

Questions people ask

Is there an official Instagram MCP server?

Not for public Instagram profiles. Meta publishes an ads MCP server at mcp.facebook.com/ads that manages your own Meta ad accounts. For Instagram content research on public accounts, use a third-party server.

Do I need an Instagram login or a Meta developer app?

It depends. Hosted research servers like Manifold need neither. Open-source servers built on Meta's API need a Meta app and a Business or Creator account. Unofficial servers need your Instagram username and password and risk account restrictions.

Which Instagram MCP server is best?

Manifold if you want to read public Instagram data with no login or app, in any client. William-Gao/instagram-mcp or adelaidasofia/instagram-mcp if you manage Instagram Business or Creator accounts and want full control. Blotato or Outstand if you want to publish to your own account. Avoid unofficial servers unless you accept the risk of account restrictions.

Can it post to Instagram or send DMs?

Hosted publishers (Blotato, Outstand) and official API servers such as William-Gao/instagram-mcp and adelaidasofia/instagram-mcp can publish and reply to comments, and DMs need Meta's App Review. Manifold's tools search and read public profiles, posts, reels, comments and hashtags, and your agent can draft a caption or reply for you to post.

Does it work with personal Instagram accounts?

For reading, yes: Manifold, HasData and Instapi read any public account. For posting, Meta's API requires an Instagram Business or Creator account, so hosted publishers and official API servers only work on those account types. Switching an account to Business or Creator is free.

How much does Manifold's Instagram MCP cost?

Manifold is pay per call. Every workspace starts with 500 free credits. After that, top-ups start at $10 and Pro starts at $20/mo.

Sources

Jesse Sibley

Jesse Sibley

Founder of Manifold. A growth engineer who has worked with London startups for eight years.

  • 11 min read

    The best YouTube MCP servers

    Eight MCP servers that let your agent read YouTube transcripts, comments, channels and search results, compared on what they cover, setup and price.

  • 9 min read

    The best ad library MCP servers for competitor research

    Five MCP servers that let your agent search the public ad libraries of Meta, Google, TikTok, LinkedIn and Microsoft, compared on coverage, setup and price.

  • 11 min read

    Ahrefs MCP: setup guide and alternatives

    Ahrefs MCP connects your agent to Ahrefs' data: keywords, backlinks, competitors, rank tracking and site audits. This guide covers the plans that include it, setup in Claude, ChatGPT and Cursor, how units are spent, and when a hosted alternative fits better.