Instapdown Mcp

io.github.farukkolipPublished by GitHub account farukkolipv0.1.1Updated Oct 24, 2026

16 Instagram creator tools: downloaders, engagement audit, hashtags, hooks, best-time, calendar.

Overview

AI-generated overview

A local MCP server exposing 16 Instagram creator tools: media downloaders, engagement analytics, hashtag and hook generation, best-time data and a content日历.

What you can do
Download Reels, videos, stories, carousels, photos, profile pictures and Reel audio from public accounts as direct media URLs and arrays of slides or stories, with no watermark or re-encoding claimed for videos and Reels and the source m4a track for audio extraction. Audit engagement for a username or calculate weighted engagement rate from followers and interactions, with tier benchmarks and a performance rating. Generate Reels hook templates, search hashtags with real post counts, list curated seed niches and audit a creator's hashtag frequency. Produce Unicode font variants, country-specific best-time-to-post slots with a seven-day heatmap, and 2026 content calendar entries with native-钩子
When to use it
Useful when you plan or audit Instagram content from a chat client and want media links, engagement metrics, hashtag research, hook ideas, posting-time data or calendar entries without leaving the conversation. It is aimed at public-account research and creator planning, not private-account access.
Requirements
Runs locally as an npm package via npx, so Node.js and network access are needed. No account, API key or config is required. An optional INSTAPDOWN_BASE_URL environment variable overrides the API host, defaulting to the Instapdown service. Desktop MCP clients only.
Before you install
All requests go to the third-party Instapdown API, so the usernames, URLs and topics you submit leave your machine. Downloaders only work for public accounts; private accounts return HTTP 422. Downloading and reusing Instagram media may raise copyright or platform-terms issues. The README claims no watermark and no re-encoding, which you should verify before relying on it.

Installation

In SourceWeft

  1. Open Instapdown Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

instapdown-mcp

[instapdown-mcp MCP server] [npm version] [License: MIT]

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

bash
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):

json
{  "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:

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

Default: https://instapdown.com.


Development

bash
git clone https://github.com/farukkolip/instapdown-mcpcd instapdown-mcpnpm installnpm run buildnode 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.

Source: README.md at commit bde5fa4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts