{
  "markdown": "# InstantClips MCP\n\n**English** · [Español](README.es.md) · [简体中文](README.zh-CN.md)\n\n[![M8ven Verified](https://m8ven.ai/badge/mcp/instantclips-mcp-1k56q7?variant=verified)](https://m8ven.ai/mcp/instantclips-mcp-1k56q7)\n\n[InstantClips](https://instantclips.ai) turns an e-commerce product into short-form vertical\nvideo for TikTok, Instagram Reels and Stories. It runs a hosted **MCP server**, so Claude Code,\nCodex, Cursor, VS Code, the Claude app, ChatGPT or any other MCP client can do what the web app\ndoes: import a product, draft the plan, and generate the video.\n\n**This is not a text-to-video generator.** InstantClips reads the product page — photos, price,\ndetails — and builds the ad from what is actually there. The plan is written first and shown to\nyou; the video follows the plan. That is why it is cheap enough to run across a catalogue, and why\nthe result is the product you sell rather than a guess at it.\n\nFree to start: the welcome credits cover the first video, and there is no card to enter. After\nthat, one-time credit packs, or an Agency membership for anyone running several brands. See\n[pricing](https://instantclips.ai/#pricing).\n\n- **Where it fits.** Beside a scheduler (Postiz, Buffer) that posts what comes back. Beside an\n  attribution tool that tells you which hook worked. Instead of an editor when you have a product\n  page and no footage.\n- **Not for.** Cinematic hero films. A presenter reading your script. Horizontal 4K. Products with\n  no page and no photos.\n- **Built for.** Shopify sellers, dropshippers, brands and agencies running social for several\n  stores at once.\n\n**The product server stays hosted.** This repository contains its connection guide, registry\nmetadata, example HTTP client and a small open-source stdio adapter for clients that cannot connect\nto a remote server directly. The adapter answers initialization, ping and tool discovery from a\ngenerated snapshot, then sends authenticated tool calls to the hosted endpoint. The hosted server\nremains the source of truth; the product implementation is not duplicated here.\n\n## Endpoint\n\n|            |                                                                                   |\n| ---------- | --------------------------------------------------------------------------------- |\n| Endpoint   | `https://app.instantclips.ai/mcp`                                                 |\n| Transport  | Streamable HTTP, stateless                                                        |\n| Method     | `POST`, JSON-RPC 2.0                                                              |\n| Auth       | Sign in when your client asks (OAuth 2.1), or `Authorization: Bearer <token>` for callers with no browser |\n\nPaste one address into your assistant and sign in when it asks. That is the whole setup. The\nfirst time it calls, the server sends you to sign in to InstantClips and approve the assistant;\nthere are no keys to copy. Every assistant you approve is listed under **Authorized apps** in\nsettings, where you can disconnect it.\n\nThe connection is to your own account: same brands, products, credits and plan limits as the web\napp. Signing in creates an account if you do not have one, with credits for the first video.\n\nOpening the endpoint in a browser returns the [setup page](https://app.instantclips.ai/mcp)\nrather than a protocol error, with one-click install buttons for Cursor and VS Code.\n\n## Install\n\nConnect to the hosted endpoint directly whenever your client supports Streamable HTTP; it takes\nyou through sign-in on first use. Use a token and the stdio adapter (under \"No browser?\" below)\nonly for scripts and automated runners that cannot open a sign-in page.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http instantclips https://app.instantclips.ai/mcp\n```\n\nThen run `/mcp` inside Claude Code and choose InstantClips to sign in.\n\n### Codex\n\nAdd to `~/.codex/config.toml`, which covers the CLI, the app and the IDE extension together:\n\n```toml\n[mcp_servers.instantclips]\nurl = \"https://app.instantclips.ai/mcp\"\n```\n\nThen run `codex mcp login instantclips` to sign in.\n\n### Cursor and VS Code\n\nOne-click install buttons are on the [setup page](https://app.instantclips.ai/mcp). They open\nthe app, add InstantClips, and sign you in on first use.\n\n### Claude app and ChatGPT\n\nClaude app: add a custom connector with this address and sign in when it asks. ChatGPT on the\nweb: turn on Developer mode under Settings, Apps, Advanced, then add the address as a connector;\non a Business or Enterprise workspace an admin publishes it as an app for everyone instead. The\nChatGPT desktop app takes the same address under Settings, MCP servers, and shares it with Codex.\n\n### Any other MCP client or agent\n\nOpenClaw, Hermes, or an agent you wrote yourself: point it at the address over Streamable HTTP.\nThe server announces its sign-in flow the standard way, so a client that follows the spec needs\nnothing else. Anything that cannot open a sign-in page uses a token instead, below.\n\n### No browser? Use an access token\n\nScripts, CI jobs and agents that cannot open a sign-in page authenticate with a long-lived token\ninstead. Mint one at\n**[app.instantclips.ai/settings#ai-access](https://app.instantclips.ai/settings#ai-access)**. It\ngives full access to your account, so keep it out of anything you commit.\n\nWith a token, the same clients look like this:\n\n```bash\n# Claude Code\nclaude mcp add --transport http instantclips https://app.instantclips.ai/mcp --header \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n```toml\n# Codex, in ~/.codex/config.toml\n[mcp_servers.instantclips]\nurl = \"https://app.instantclips.ai/mcp\"\nhttp_headers = { Authorization = \"Bearer YOUR_TOKEN\" }\n```\n\nTo keep the token out of the Codex file, swap the header for `bearer_token_env_var = \"INSTANTCLIPS_TOKEN\"`\nand export it in your shell instead. The Claude app takes a token as a request header on the\nconnector (request headers are still in beta); ChatGPT connectors sign in through the sign-in flow\nrather than a pasted key. Any other client sends an `Authorization: Bearer` header. Nothing on the\nwire is InstantClips-specific.\n\n#### Stdio-only clients and headless runners\n\nThe `instantclips-mcp` npm package is a thin stdio-to-HTTPS adapter. It serves initialization and\ntool discovery locally for a fast, credential-free cold start, then reads the token from the\nenvironment and sends tool calls to InstantClips:\n\n```json\n{\n  \"mcpServers\": {\n    \"instantclips\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"instantclips-mcp\"],\n      \"env\": {\n        \"INSTANTCLIPS_TOKEN\": \"YOUR_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nFor an automated connectivity check, including the live tool names:\n\n```bash\nINSTANTCLIPS_TOKEN=\"your-token\" npx -y instantclips-mcp --check --json\n```\n\nThe token is accepted only through `INSTANTCLIPS_TOKEN`, never as a command-line argument, so it\ndoes not appear in the process list. It is required for tool calls, but not for `initialize`,\n`ping`, or `tools/list`. Node.js 20 or newer is required.\n\n## Starter prompts\n\nFive to begin with. Swap in a link or a product name.\n\n1. \"Make a video ad for this product: [URL]\"\n2. \"Import every product on this collection page and draft plans for all of them. Don't generate anything yet.\"\n3. \"Show me the plan for [product] and rewrite the hook to lead with the price.\"\n4. \"Make three videos for [URL] with three different hooks, so I can test them.\"\n5. \"Which of my brands is this product for? Then make the video.\"\n\n## Tools\n\nThe workflow, in order:\n\n1. **Import** — `import_product_from_url` for a store page, or `create_product_from_images` when\n   there is no page to read.\n2. **Wait for the draft** — poll `get_product` until the import and the plan have finished.\n3. **Read and steer it** — the plan comes back as text: hook, content focus, format, execution\n   guidelines, restrictions. `update_video_direction` edits it, `redraft_video_direction` asks\n   for another angle.\n4. **Generate** — `generate_video`.\n5. **Collect** — poll `get_video` for the finished MP4 and a public share link.\n\nBrands work the same way: `list_brands`, `create_brand`, `set_product_brand`. Every video is\ndrafted in a brand's voice, so an import whose storefront matches no existing brand stops and asks\nrather than guessing.\n\nEach tool's exact parameters are published by the hosted server. The generated\n[`manifest/instantclips-mcp.json`](manifest/instantclips-mcp.json) snapshot lets stdio clients and\nregistries inspect those same schemas without a credential. Maintainers refresh it with\n`INSTANTCLIPS_TOKEN=\"...\" npm run sync:manifest`; `npm run check:manifest` fails when the committed\nsnapshot differs from the live server. Run `python example.py tools` below when you specifically\nwant to print the live schemas over HTTP.\n\n## Credits\n\nImporting a product, drafting the plan and editing it are all **free**. `generate_video` is the\nonly tool that spends credits, and it requires your explicit go-ahead — the tools report the cost\nfirst. An agent cannot quietly run up a bill. See [pricing](https://instantclips.ai/#pricing).\n\n## example.py\n\nA dependency-free MCP client — Python 3.9+, standard library only, no `pip install`. It\nauthenticates with a token, since a script has no browser to sign in with.\n\n```bash\nexport INSTANTCLIPS_TOKEN=\"your-token\"\n\npython example.py tools                 # every tool, with its live input schema\npython example.py call list_brands '{}' # call one tool with JSON arguments\n```\n\n`tools` is the one to run first: it prints the real parameter names and types for every tool, which\nis what you need before scripting the workflow above.\n\n## Links\n\n- [instantclips.ai/automate](https://instantclips.ai/automate/) — what the automation is for: a\n  real result made from a store page, starter prompts, the tools in order, and the rules. It does\n  not repeat the setup; this file and the app's setup page are where that lives.\n- [app.instantclips.ai/llms.txt](https://app.instantclips.ai/llms.txt) — machine-readable\n  description of the product and the tool sequence\n- [Terms](https://app.instantclips.ai/terms) · [Privacy](https://app.instantclips.ai/privacy)\n\n## Registry\n\n`server.json` is this server's entry in the [official MCP registry](https://registry.modelcontextprotocol.io),\nwhich the other directories ingest from. One `ai.instantclips/instantclips` entry carries both the\nhosted endpoint in `remotes` and the stdio adapter in `packages`, so a host can choose the transport\nit supports without creating two identities for the same tool surface.\n\nThe npm package's `mcpName` must exactly match that registry name. The repository link points to the\nopen-source adapter; the hosted product implementation is not in this repository.\n\nThe `ai.instantclips` namespace is the reverse-DNS of the domain, which requires publishing under\nDNS or HTTP domain auth rather than GitHub auth. Authenticating with GitHub instead would force the\nentry into `io.github.instantstudioai/...` and give up the branded namespace.\n\nPublish the npm package first, then re-publish this same registry entry with\n`mcp-publisher publish` after bumping its `version`. Domain authentication keeps the branded\n`ai.instantclips` namespace; do not replace it with an `io.github.*` name. The signing key stays out\nof the repository — `.gitignore` covers `*.pem`, and a committed private key is a published one.\n\n`glama.json` is the separate, Glama-specific file that claims the listing there. A server under an\norganisation rather than a personal account can only be claimed with that file present.\nIt carries ownership only. In Glama's Dockerfile form, use build steps\n`[\"npm install --omit=dev\"]`, CMD arguments `[\"node\", \"./bin/instantclips-mcp.js\"]`, and any dummy\nvalue for the required `INSTANTCLIPS_TOKEN` placeholder. Glama's initialization and tool-quality\nchecks use the bundled manifest and never transmit that placeholder upstream. Do not put a real\naccount token into a third-party build sandbox.\n\n## License\n\nMIT — see [LICENSE](LICENSE). The license covers this repository's contents; use of the hosted\nservice is governed by the [Terms of Service](https://app.instantclips.ai/terms).\n",
  "bytes": 12156,
  "sha": "dda2ad8a36b2c9a0d94880376466f5a7584935ed116e498186375148dbb500b6",
  "repo_slug": "instantstudioai/instantclips-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_instantclips_instantclips_72eadcfa/readme"
}