Skip to main content
Glama
instapdown-mcp

instapdown-mcp

by farukkolip

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

npx -y instapdown-mcp

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

Related MCP server: xtapdown-mcp

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

Tool

Input

Returns

download_reels

Reel URL

Original 9:16 HD MP4, no watermark

download_video

Feed video URL

Original MP4, no re-encoding

download_story

Username

Every active Story in the 24h window

download_profile_picture

Username

Full-resolution profile JPG

download_carousel

Carousel URL

Every slide as a media array

download_photo

Single-image post URL

Original full-resolution JPG

extract_reel_audio

Reel URL

Source m4a audio track URL

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

Analytics

Tool

Input

Returns

engagement_health_check

Username

Weighted ER, save rate, comment rate, tier benchmark from the last 12 posts

engagement_calculator

Followers + interactions

Weighted ER (like×1 + comment×2 + save×3 + share×4), tier benchmark, performance rating

Content strategy

Tool

Input

Returns

generate_reels_hooks

Niche + optional country/language

10 verified 2026 hook templates from the 900-hook library

search_hashtags

Topic + locale

Real Instagram post counts for the returned hashtags

get_hashtag_niche

Optional category

25 curated seed niches

audit_creator_hashtags

Username

Hashtag frequency map from the last 12 posts

generate_instagram_fonts

Text + optional style

22 Unicode font variants (Bold, Italic, Script, Fraktur, Double Struck, Monospace, Small Caps, Circled, Upside Down, …)

get_best_time_to_post

Country code

5 prime slots + 7-day heatmap, sourced from Buffer 2026 (30M+ posts)

get_content_calendar

Market + date range + niche

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

Available Tools

8 tools
audit_creator_hashtagsA

Extract the exact hashtag set any public Instagram creator uses on their last 12 posts, ranked by frequency. Reveals someone's actual working tag stack, not what they say they use. Public accounts only.

Inputs: username (required).

download_reelsA

Download an Instagram Reel from a public post URL. Returns the original 9:16 HD MP4 URL and audio track, with no watermark and no re-encoding. Public accounts only — private accounts return HTTP 422.

Inputs: url (required).

download_storyA

Fetch every currently-active Instagram Story for a public username within the 24-hour visibility window. Returns MP4 or JPG URLs for each Story frame. Private accounts return HTTP 422.

Inputs: username (required).

generate_instagram_fontsA

Convert plain text into Instagram-compatible Unicode "fonts" for bio, name field and captions. Not real fonts — Unicode Mathematical Alphanumeric Symbols and other substitutions Instagram renders as if styled. 22 styles supported including Bold, Italic, Script (cursive), Fraktur (gothic), Double Struck, Monospace, Small Caps, Circled, Squared, Upside Down. Pass one style name or omit to get every style back.

Inputs: text (required), style.

get_best_time_to_postA

Return data-driven optimal Instagram posting windows for a country. Source: Buffer 2026 verified dataset (30M+ posts) mapped to each market's local timezone. Returns 5 prime posting slots (with notes on which signal each optimizes for — Reels Save rate, Watched-to-end, comment threads etc.) plus a 7-day heatmap. Supported markets: US, GB, CA, AU, BR, MX, ES, IT, DE, FR, NL, SE, TR, JP, SA, AE, RU.

Inputs: country (required).

get_content_calendarA

Return the Instagram content calendar entries for a market, filtered by an optional date range and/or niche. Each entry carries a native-language Reels hook and a hashtag set. Islamic-lunar and astronomical dates use verified 2026 and 2027 anchors. Markets: US, GB, CA, AU, BR, MX, ES, IT, DE, FR, NL, SE, TR, JP, SA, AE, RU, GLOBAL. Use "GLOBAL" for cross-market dates (Christmas, New Year, Ramadan, etc).

Inputs: market (required), to, from, limit, +1 more.

search_hashtagsA

Live-search Instagram's public hashtag index for a topic and return real post counts. Not cached, not fabricated — reflects the current state of the public hashtag graph. Country + language shape the returned tag mix (Turkish tags for TR, Arabic for SA/AE, etc). Use this when the user gives a free-form topic; use get_hashtag_niche if they name one of the 25 curated seed niches.

Inputs: topic (required), locale.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a unique function: downloading specific content types (carousel, reels, story), analyzing hashtags for creators vs. searching hashtags by topic, generating fonts, and providing posting time and content calendar insights. There is no overlapping purpose; descriptions clearly differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, such as 'download_carousel', 'get_best_time_to_post', and 'search_hashtags'. The verbs are appropriate for the action (download, audit, generate, get, search), making the set predictable.

    Tool Count5/5

    With 8 tools, the server is well-scoped for an Instagram utility. Each tool covers a distinct aspect (downloading, hashtag analysis, scheduling, formatting) without being overwhelming or insufficient.

    Completeness4/5

    The tool set covers core Instagram download and analytics needs: downloading stories, reels, carousels; analyzing hashtags; scheduling posts; and generating fonts. A minor gap is the absence of a dedicated single-image download (though carousel may handle it) and lack of engagement metrics, but overall it's comprehensive for its stated purpose.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides LLM clients with direct access to XTapDown's Twitter creator toolkit, enabling tweet downloads, engagement calculations, content generation, and trend analysis without authentication or rate limits.
      14
      60 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for downloading Instagram content (videos, reels, audio, carousels) using yt-dlp, with tools for downloading media and fetching metadata. Supports stdio and HTTP transports.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to retrieve read-only public Instagram data through 27 tools covering profiles, posts, reels, stories, highlights, comments, likers, followers, hashtags, places, audio and keyword search. No login is required, and every response reports remaining API credits.
      27
      1
      MIT