Skip to main content

instagram-data-mcp

An MCP server for public Instagram data. It gives Claude, Cursor and any other MCP client 27 read-only tools: profiles, posts, reels, stories, highlights, comments, likers, followers, hashtags, places, audio and search.

It wraps the Instagram Data API. Nothing logs in to Instagram, and nothing can post, follow or like. Public data only.

Get a key

Sign up at https://fastsocial.co/instagram-api. There is a free plan.

Install

Claude Code:

claude mcp add instagram-data --env IG_DATA_API_KEY=your_key -- uvx instagram-data-mcp

Claude Desktop, Cursor and other clients (mcpServers in the client's config file):

{
  "mcpServers": {
    "instagram-data": {
      "command": "uvx",
      "args": ["instagram-data-mcp"],
      "env": { "IG_DATA_API_KEY": "your_key" }
    }
  }
}

No uvx? pip install instagram-data-mcp and use "command": "instagram-data-mcp" instead.

Tools

Tool What it does
instagram_profile Get an Instagram profile
instagram_user_id Instagram username to user id
instagram_username Instagram user id to username
instagram_check Check if an Instagram handle exists and is public
instagram_posts Get recent Instagram posts
instagram_reels Get an account's Instagram reels
instagram_tagged Get posts an account is tagged in
instagram_post Get one Instagram post or reel
instagram_media Download URLs for a post, reel or carousel
instagram_comments Get comments on an Instagram post
instagram_comment_replies Get replies to an Instagram comment
instagram_likers Get accounts that liked an Instagram post
instagram_insights Instagram engagement rate calculator
instagram_followers Get an account's followers
instagram_following Get accounts an account follows
instagram_similar Find similar Instagram accounts
instagram_stories View Instagram stories anonymously
instagram_highlights Get Instagram story highlights
instagram_highlight Get the items in one highlight
instagram_search Search Instagram accounts, hashtags and places
instagram_hashtag Get posts for an Instagram hashtag
instagram_place Get an Instagram location
instagram_place_posts Get posts tagged at an Instagram location
instagram_audio Get an Instagram audio track and the reels using it
instagram_audio_search Search Instagram music and sounds
instagram_reels_search Search Instagram reels by keyword
instagram_usage Your usage this month

Each call costs API credits (stories and highlights cost 3, most others 1). Every response includes meta.credits_remaining. Full reference: https://fastsocial.co/instagram-api/docs

Things to ask it

  • "Compare the engagement rate of @nasa and @spacex."
  • "Download every slide of this carousel: https://www.instagram.com/p/..."
  • "Show me @natgeo's current stories and summarise them."
  • "Find 10 accounts similar to @humansofny."

Settings

Env var Default
IG_DATA_API_KEY none Required
IG_DATA_API_BASE https://data.fastsocial.co
IG_DATA_API_TIMEOUT 60 Seconds

License

MIT

Release files for instagram-data-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for instagram-data-mcp 0.1.1
File Size Uploaded
instagram_data_mcp-0.1.1.tar.gz 12.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for instagram-data-mcp 0.1.1
File Interpreter ABI Platform
instagram_data_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 24.5 kB

Release files / instagram_data_mcp-0.1.1.tar.gz

Download URL instagram_data_mcp-0.1.1.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
58ed7fb5d11eb95578f38f161ae9b233b8745e75e026dbf3e6171e5ed953ed5c
BLAKE2b-256 checksum
How to use checksums
6c7149a8bda4b57f245c30cf30f50b6cd28af2532c5b44af28bde5ad4a723dce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.

Transparency log

Release files / instagram_data_mcp-0.1.1-py3-none-any.whl

Download URL instagram_data_mcp-0.1.1-py3-none-any.whl
Size 12.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a9ddc057783c1823cc5f645ebeec9679291299c69adab579b7558c48357907d1
BLAKE2b-256 checksum
How to use checksums
018b1f253b8faaae80f165b4462fe9b44a8a58a329c4ebaa4100a3b2b01ca4a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page