Instagram Reels MCP

Add Reels parsing to MCP-capable agents.

Fastdown is a local MCP stdio server backed by a Cloudflare API. Agents can inspect public Instagram Reels links, return structured metadata, or save media files when the user asks.

Tool descriptions matter

The MCP server exposes narrow tools so agents can pick local download versus metadata parsing without guessing.

Download

download_video

Use when the request says download, save, fetch, archive or get a local copy.

Inspect

parse_video

Use when the request asks for URLs, media entries, title, author or platform metadata.

Limits

quota

Use when the user asks how many successful parses remain today.

Directory submission angle

For MCP directories, describe this as a public video parsing and local download capability for AI agents.

  1. 1Publish the GitHub README with install, auth and MCP configuration snippets.
  2. 2Submit the repo to MCP registries and directories with download_video as the primary tool.
  3. 3Link back to Fastdown docs, pricing, OpenAPI and /llms.txt for agent crawlers.

What a parse returns

A parse is not a download button. It is structured output: every rendition, whether it carries a watermark, and how much quota is left.

$ fast-download parse "https://www.instagram.com/reel/xxxx/" --json
{
  "platform": "instagram_reels",
  "author": "@example",
  "duration": 27,
  "media": [{ "quality": "1080p", "ext": "mp4", "watermark": false }]
}

Coverage and limits

Stated plainly, because a tool that hides its edges is a tool you cannot build on.

CapabilityStatusNotes
Public ReelsSupportedFull URL or share sheet text
Public feed videosSupportedSame parser path
Private accountsNot supportedNo session, no access
StoriesNot supportedExpire and require auth
CarouselsPartialVideo items only
Audio extractionSupportedM4A from the same source

Boundaries and compliance

Four constraints that make the tool safe to put inside an automated workflow.

Questions people actually ask

Can an MCP client download Instagram Reels?

Yes, for public Reels. The agent calls download_video with the Reel URL and gets a local file path back.

Do I need to log into Instagram?

No. Fastdown does not accept Instagram credentials at all, which is also why private accounts are unsupported.

Why do some Reels fail?

The post was deleted, belongs to a private account, is age-gated, or Instagram rate-limited the request. Retry later for the last case.

Is the quality the original upload?

Yes. Instagram serves a single video rendition to anonymous viewers and that is the file you receive.

Three ways people actually run it

Reels arrive as share-sheet text more often than as clean URLs, so the parser handles both.

  1. 1Agent-side capture — Send the whole share text. The parser extracts the URL, resolves the short link and returns the media list.
  2. 2Content calendar prep — Parse a week of Reels into titles and durations first, decide what is worth downloading, then download only those.
  3. 3Editorial archive — Download to a dated folder and keep the author handle in the filename, so attribution survives the file move.