🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

instapdown-mcp

Package Overview
Dependencies
Maintainers
1
Versions
2
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

instapdown-mcp

16 Instagram creator tools as an MCP server — Reels/Story/carousel downloaders, engagement audit, hashtag search, Reels hook generator, best-time-to-post, content calendar and more.

latest
Source
npmnpm
Version
0.1.1
Version published
Weekly downloads
38
-87.74%
Maintainers
1
Weekly downloads
 
Created
Source

instapdown-mcp

16 Instagram creator tools as a Model Context Protocol server. Wraps the public API and data behind instapdown.com so any MCP client — Claude Desktop, Cursor, Cline, Zed — can download Reels, audit engagement, search hashtags, generate Reels hooks, get country-specific best-time-to-post data and browse a 2026 content calendar directly from a chat turn.

Part of the TapDown family alongside xtapdown-mcp (X / Twitter).

Install

npx -y instapdown-mcp

That's the whole install path. No account, no API key, no config.

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "instapdown": {
      "command": "npx",
      "args": ["-y", "instapdown-mcp"]
    }
  }
}

Restart Claude Desktop. In a new chat:

"Download this reel for me: https://www.instagram.com/reel/ABC123/"

Claude will call download_reels and hand back the direct MP4 URL and audio track.

The 16 tools

Downloaders

ToolInputReturns
download_reelsReel URLOriginal 9:16 HD MP4, no watermark
download_videoFeed video URLOriginal MP4, no re-encoding
download_storyUsernameEvery active Story in the 24h window
download_profile_pictureUsernameFull-resolution profile JPG
download_carouselCarousel URLEvery slide as a media array
download_photoSingle-image post URLOriginal full-resolution JPG
extract_reel_audioReel URLSource m4a audio track URL

Public accounts only. Private accounts return HTTP 422 by design.

Analytics

ToolInputReturns
engagement_health_checkUsernameWeighted ER, save rate, comment rate, tier benchmark from the last 12 posts
engagement_calculatorFollowers + interactionsWeighted ER (like×1 + comment×2 + save×3 + share×4), tier benchmark, performance rating

Content strategy

ToolInputReturns
generate_reels_hooksNiche + optional country/language10 verified 2026 hook templates from the 900-hook library
search_hashtagsTopic + localeReal Instagram post counts for the returned hashtags
get_hashtag_nicheOptional category25 curated seed niches
audit_creator_hashtagsUsernameHashtag frequency map from the last 12 posts
generate_instagram_fontsText + optional style22 Unicode font variants (Bold, Italic, Script, Fraktur, Double Struck, Monospace, Small Caps, Circled, Upside Down, …)
get_best_time_to_postCountry code5 prime slots + 7-day heatmap, sourced from Buffer 2026 (30M+ posts)
get_content_calendarMarket + date range + nicheInstagram content dates for 2026, each with a native-language Reels hook and hashtag set

Supported markets for country-varied tools: US, GB, CA, AU, BR, MX, ES, IT, DE, FR, NL, SE, TR, JP, SA, AE, RU.

Environment

Override the API host when developing locally against a staging Instapdown:

INSTAPDOWN_BASE_URL=http://localhost:3000 npx -y instapdown-mcp

Default: https://instapdown.com.

Development

git clone https://github.com/farukkolip/instapdown-mcp
cd instapdown-mcp
npm install
npm run build
node dist/test/smoke.js   # in-memory smoke test — 16 tools + 6 offline callable

License

MIT © Ömer Faruk Kolip

Instapdown is not affiliated with, endorsed by, or sponsored by Meta Platforms, Inc. or Instagram. Public content only.

Keywords

mcp

FAQs

Package last updated on 22 Jul 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts