MCP server for public Instagram data: profiles, posts, reels, stories, highlights, comments, hashtags and search. Read-only.
Instagram Data MCP server
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Connect your AI assistant to FastSocial's Instagram Data API, and it can look up public Instagram
profiles, posts, reels, stories, highlights, comments, hashtags, places and audio. Read-only: it
never posts, follows, likes or sends messages.
The server is remote. There is nothing to install or run: your assistant talks to
over Streamable HTTP. The first time it connects, a fastsocial.co page opens in your browser where
you sign in and click Allow.
This repository holds the plugin manifests (plugin.json, mcp.json and the copy Cursor reads in
.cursor-plugin/), the server.json that lists the server in the official MCP Registry as
io.github.FastSocialCo/instagram-data-mcp, and a LobeHub manifest. It contains no code that runs
on your machine. The server's code is not here.
Install
Cursor
Install the plugin from cursor.directory, or add the server to .cursor/mcp.json (one project)
or ~/.cursor/mcp.json (all projects):
Open Settings, then MCP, and connect. Cursor opens the FastSocial sign-in page.
Claude Code
Then run /mcp inside Claude Code, choose instagram-data and sign in.
Claude app (web and desktop)
1. Open Settings, then Connectors, and add a custom connector.
2. Paste https://data.fastsocial.co/mcp as the server URL.
3. Leave the OAuth client ID and secret empty.
4. Connect, and sign in on the FastSocial page that opens.
VS Code and other clients
Any client that speaks MCP over Streamable HTTP can connect with the server URL. In VS Code, add
this to .vscode/mcp.json and press Start:
What this plugin does and what data it sends
The plugin itself
The plugin is two JSON files that tell your client the server's address. It runs no code, has no
install scripts and stores nothing. Your client makes every request itself, straight to
https://data.fastsocial.co/mcp over HTTPS.
What your client sends
- **The MCP handshake:** your client's name and version, and the protocol version it speaks.
- **Each tool call:** the tool's name and its arguments, which are the things you asked about: an
Instagram username or user id, a post or reel link, a hashtag, search words, a location, audio or
highlight id, and a paging cursor. The full list is in the table below.
- **Your sign-in token or API key,** in a request header. Never in the URL.
- The usual details of any web request, such as your IP address and your client's user agent.
Nothing else is sent. The server never sees your files, your editor or your conversation, only the
arguments your assistant puts into a tool call.
What comes back
Public Instagram data as JSON, plus meta.credits_remaining. Photos and videos come back as links,
not files. Private accounts return a private_account error. Instagram account owners can opt out;
after that the API returns 451 opted_out for their account.
Read-only
Every tool reads. None changes anything on Instagram. The only thing a call changes is your own
credit balance for the month. The server marks every tool readOnlyHint: true and
openWorldHint: true in tools/list. There are no tools that write or delete.
Signing in
The first time your client connects, the server replies that it needs sign-in and says where to
find out how. Your client then opens a page on fastsocial.co in your browser. There you:
1. enter your email and the code FastSocial emails you,
2. see which app is asking, and click Allow (or Deny).
If you don't have a plan yet, a Free plan is made for you when you click Allow. You never type a
password into your assistant, and the plugin never sees or stores your credentials. Your client