# InstantClips [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/InstantStudioAI/instantclips-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1516  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/instantclips-2

## Description
Create branded vertical video ads from ecommerce product URLs or product photos.

## Tools
Capabilities this server exposes over MCP:

- **list_brands** — The account's brands, the plan's brand limit, and `account`: `credits_remaining` and
`watermarked: true` on a free account. Call it before answering `brand_decision_required`, so the
user chooses a brand by name.

- **list_products** — The account's products, newest first, including ones made on the website. Use it to find a
product_id you don't have, then `get_product`. Carries `account`, as `list_brands` does.

- **import_product_from_url** — Start a product from its page URL; returns at once, so poll `get_product`. It detects the brand, and
an external AI service reads the page into facts and ideas. A store locked to another account is
refused and reported to support.

- **create_product_from_images** — Start a product from photos when it has no page (`import_product_from_url` when it does). Photos
carry no brand: ask the user which, or pass `brand_id`. An external AI service then reads the
photos; poll `get_product`.


Through this adapter, `image_paths` (files on this machine) replaces `image_urls`; the files are uploaded directly. Send one or the other, not both.
- **get_product** — Read a product: import status, brand decision, photos, the video direction with its settings and
`credit_cost`, and its videos. Poll every 20-30 s while it imports or drafts. `next_step` says what
to do now.

- **create_brand** — Create a brand for a product waiting on `brand_decision_required` and attach it; then offer its
ideas. Ask the user first: it takes a brand slot. A photos product needs `name` from the user, and
the voice, market and keywords they give.

- **set_product_brand** — Attach a product waiting on `brand_decision_required` to an existing brand (`list_brands`), once the
user confirms it belongs there; then offer its ideas (`get_product`). `replace_identity` rewrites that brand
for every product on it.

- **update_brand** — Edit a brand's `name`, `voice`, `target_market` or `keywords` (a new list replaces the old); only
the fields you pass change. Future drafts use them; `redraft_video_direction` rewrites a direction
already drafted.

- **update_product** — Edit a product's name, description, price and posted `link_url`, and add or remove photos; only the
fields you pass change. The direction is drafted from these facts, so `redraft_video_direction`
after changing them.


Through this adapter, `add_image_paths` (files on this machine) adds photos; the files are uploaded directly.
- **update_video_direction** — Edit the next video's `creative_direction`, its idea (`creator_note`), settings and photos; only the
fields you pass change. Settings are parameters, not direction text. A new idea, length or ratio
rewrites the direction: poll `get_product`.

- **redraft_video_direction** — Draft the next video's direction through an external AI service: with none and no idea yet, from
one of the product's ideas we choose; else another take in its format. It overwrites edits:
confirm first. Poll `get_product`.

- **generate_video** — Render the video. SPENDS THE USER'S CREDITS: ask first, with the direction, settings, cost and any
watermark, and pass the cost as `expected_credit_cost`. External services render it; it gets a
public share page and may send account email.

- **get_video** — Check one video's render. `next_step` says what to tell the user and when to poll again; follow it,
since it knows how long this render has run. Mention a watermark only when `watermarked` appears.
Done or failed: `launched_with` is its plan.

- **rate_video** — Record the user's own verdict on a finished video they have watched: `reaction`, and optional
`issues` and `comment` in their words. Never rate for them, and ask at most once. A second call
replaces the rating.

- **send_feedback** — Send the InstantClips team a note about these tools: one that failed or surprised, or something the
user wanted that no tool does. Show the user the note and send it only with their OK. Not for
support or ratings.


## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "instantclips": {
    "command": "npx",
    "args": ["-y","instantclips-mcp"],
    "env": {
      "INSTANTCLIPS_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `INSTANTCLIPS_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What InstantClips does

InstantClips turns ecommerce product information into short-form vertical video ads intended for TikTok, Instagram Reels, and Stories. It can read a storefront product page, including its images, price, and product details, or work from product photos when no public page is available. The service drafts a creative direction before rendering so the direction can be reviewed and edited first.

Brand identity is central to the workflow. Each product is associated with a brand whose voice, target market, and keywords guide the draft. Products waiting for a brand decision cannot receive a video direction until the user confirms an existing brand or creates a new one.

## How it works

The hosted endpoint uses stateless Streamable HTTP at `https://app.instantclips.ai/mcp`. Clients authenticate through OAuth 2.1 during sign-in, while headless callers can send a bearer token. The server operates on the connected InstantClips account, including its products, brands, credits, and plan limits.

Product imports and direction drafting are asynchronous. After importing by URL or hosted images, poll `get_product` until the import is complete, the brand decision is resolved, and direction drafting has finished. Video rendering is also queued separately. It normally takes 5 to 15 minutes, and `get_video` provides the render status and resulting download or share links.

Generation sends product photos, brand information, and creative direction to external generation services. It charges credits when launched, refunds credits automatically for failed renders, and may send an account email when a video completes.

## Setup and configuration

For clients that support remote Streamable HTTP, add the endpoint directly and complete the InstantClips sign-in flow. The repository documents setup for Claude Code, Codex, Cursor, VS Code, the Claude app, and ChatGPT. Other MCP clients can connect if they support the standard sign-in flow.

Headless scripts and clients without a browser can use a long-lived access token created in InstantClips settings. The open-source `instantclips-mcp` npm package provides a stdio-to-HTTPS adapter for clients that cannot connect to a remote server. It reads the token from `INSTANTCLIPS_TOKEN`; Node.js 20 or newer is required for this adapter. The adapter can upload local files using `image_paths` and `add_image_paths`, rather than requiring publicly reachable image URLs.

Keep access tokens out of source control. The adapter accepts the token through its environment rather than a command-line argument.

## Tools and capabilities

The MCP tool set supports the complete product-to-video workflow:

- `list_brands` and `list_products` inspect account brands, plan limits, and imported products.
- `import_product_from_url` creates or retries a product import from a storefront URL.
- `create_product_from_images` creates a product from hosted or attached photos.
- `get_product` returns import state, brand state, direction settings, images, and generated videos.
- `create_brand`, `set_product_brand`, and `update_brand` manage brand assignment and identity.
- `update_product` changes product facts, links, and images.
- `update_video_direction` edits creative text, notes, selected images, duration, ratio, resolution, and audio settings.
- `redraft_video_direction` replaces the current direction with a newly drafted angle.
- `generate_video` launches a paid render after the user approves the direction and cost.
- `get_video` reports whether a render is pending, generating, complete, or failed.

Imports, brand operations, product edits, and direction drafting do not spend credits. `generate_video` does, so the user should be shown the direction and expected credit cost before it is called.

## Limitations and notes

InstantClips is designed for product-based vertical ads rather than cinematic hero films, presenter-led scripts, horizontal 4K output, or products with neither a public page nor photos. A single render uses at most nine usable images, and individual images over 8 MB are skipped. The image endpoint cannot read arbitrary files from a caller's machine; local files require the stdio adapter.

The server does not monitor jobs independently or wake a disconnected session. A queued render continues after the session ends, with the workbench link and completion email serving as the reliable delivery paths. Free-account settings may be reduced to the account's limits, and generated videos may carry a watermark on free accounts.

_Full upstream README: https://allmcps.com/mcp/instantclips-2/readme_

