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.0

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.0
File Size Uploaded
instagram_data_mcp-0.1.0.tar.gz 10.4 kB Details

Built distribution (wheel)

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

Total release size: 22.4 kB

Release files / instagram_data_mcp-0.1.0.tar.gz

Download URL instagram_data_mcp-0.1.0.tar.gz
Size 10.4 kB
Tags Source
SHA-256 checksum
How to use checksums
893ef008d65a23e820e86125df9d06ad904b45545da0144d946d35043f70ca88
BLAKE2b-256 checksum
How to use checksums
8bccdaf334da405470cd1c383914aa0683b7954ec3ce11472a150d7b44106d07
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.0-py3-none-any.whl

Download URL instagram_data_mcp-0.1.0-py3-none-any.whl
Size 11.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
350ca8c1e9cf917d1170a37936c54130709617c140399f444dda1c2eeaedaef8
BLAKE2b-256 checksum
How to use checksums
13d8e3d99fa82ddb993e0ed2bb8ac7628028963067998b0f0f39cfebd8e0270a
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.1

2 release files

This release

0.1.0 This release

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