instantclips-mcp 1.2.0 → 1.4.0

package/README.es.md

@@ -2,11 +2,30 @@
 
 [English](README.md) · **Español** · [简体中文](README.zh-CN.md)
 
+[![M8ven Verified](https://m8ven.ai/badge/mcp/instantclips-mcp-1k56q7?variant=verified)](https://m8ven.ai/mcp/instantclips-mcp-1k56q7)
+
 [InstantClips](https://instantclips.ai) convierte un producto de comercio electrónico en vídeos
 verticales cortos para TikTok, Instagram Reels y Stories. Funciona como un **servidor MCP alojado**,
 por lo que Claude Code, Codex, Cursor, VS Code, la aplicación de Claude, ChatGPT o cualquier otro
-cliente MCP pueden hacer lo mismo que la aplicación web: importar un producto, preparar la
-dirección creativa y renderizar el vídeo.
+cliente MCP pueden hacer lo mismo que la aplicación web: importar un producto, preparar el plan y
+generar el vídeo.
+
+**No es un generador de texto a vídeo.** InstantClips lee la página del producto (fotos, precio,
+detalles) y construye el anuncio a partir de lo que realmente hay allí. El plan se escribe primero
+y se te muestra; el vídeo sigue el plan. Por eso resulta lo bastante económico para recorrer un
+catálogo entero, y por eso el resultado es el producto que vendes y no una suposición.
+
+Gratis para empezar: los créditos de bienvenida cubren el primer vídeo y no hace falta introducir
+ninguna tarjeta. Después, paquetes de créditos de pago único o una membresía Agency para quien
+gestiona varias marcas. Consulta los [precios](https://instantclips.ai/#pricing).
+
+- **Dónde encaja.** Junto a un programador de publicaciones (Postiz, Buffer) que publique lo que
+  se genera. Junto a una herramienta de atribución que te diga qué gancho funcionó. En lugar de un
+  editor cuando tienes una página de producto y ningún metraje.
+- **Para qué no sirve.** Películas cinematográficas de marca. Un presentador leyendo tu guion.
+  4K horizontal. Productos sin página y sin fotos.
+- **Pensado para.** Vendedores de Shopify, dropshippers, marcas y agencias que llevan las redes de
+  varias tiendas a la vez.
 
 **El servidor del producto permanece alojado.** Este repositorio contiene su guía de conexión, los
 metadatos de registro, un cliente HTTP de ejemplo y un pequeño adaptador stdio de código abierto
@@ -17,33 +36,41 @@ sigue siendo la fuente de verdad; la implementación del producto no se duplica
 
 ## Endpoint
 
-|            |                                            |
-| ---------- | ------------------------------------------ |
-| Endpoint   | `https://app.instantclips.ai/mcp`          |
-| Transporte | Streamable HTTP, sin estado                |
-| Método     | `POST`, JSON-RPC 2.0                       |
-| Auth       | `Authorization: Bearer <token>`            |
+|            |                                                                                                   |
+| ---------- | ------------------------------------------------------------------------------------------------- |
+| Endpoint   | `https://app.instantclips.ai/mcp`                                                                 |
+| Transporte | Streamable HTTP, sin estado                                                                       |
+| Método     | `POST`, JSON-RPC 2.0                                                                              |
+| Auth       | Inicio de sesión cuando el cliente lo pida (OAuth 2.1), o `Authorization: Bearer <token>` para procesos sin navegador |
+
+Pega una sola dirección en tu asistente e inicia sesión cuando te lo pida. Esa es toda la
+configuración. La primera vez que llama, el servidor te lleva a iniciar sesión en InstantClips y a
+autorizar al asistente; no hay claves que copiar. Cada asistente que autorizas aparece en
+**Aplicaciones autorizadas** dentro de los ajustes, donde puedes desconectarlo.
 
-Genera un token en **[app.instantclips.ai/settings#ai-access](https://app.instantclips.ai/settings#ai-access)**.
-El token da acceso a tu propia cuenta: las mismas marcas, productos, créditos y límites del plan
-que en la aplicación web. Al iniciar sesión se crea una cuenta si todavía no tienes una, con
-créditos gratuitos para empezar.
+La conexión es con tu propia cuenta: las mismas marcas, productos, créditos y límites del plan que
+en la aplicación web. Al iniciar sesión se crea una cuenta si todavía no tienes una, con créditos
+para el primer vídeo.
 
-Al abrir el endpoint en un navegador, aparece la página de configuración en lugar de un error de
-protocolo, con botones de instalación de un clic que introducen el token por ti.
+Al abrir el endpoint en un navegador aparece la
+[página de configuración](https://app.instantclips.ai/mcp) en lugar de un error de protocolo, con
+botones de instalación de un clic para Cursor y VS Code.
 
 ## Instalación
 
-Conéctate directamente al endpoint alojado siempre que tu cliente admita Streamable HTTP. Usa el
-adaptador stdio descrito abajo solo para clientes y procesos automatizados que requieran un comando
-local.
+Conéctate directamente al endpoint alojado siempre que tu cliente admita Streamable HTTP; te
+guiará por el inicio de sesión la primera vez. Usa un token y el adaptador stdio (en «¿Sin
+navegador?», más abajo) solo para scripts y procesos automatizados que no pueden abrir una página
+de inicio de sesión.
 
 ### Claude Code
 
 ```bash
-claude mcp add --transport http instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"
+claude mcp add --transport http instantclips https://app.instantclips.ai/mcp
 ```
 
+Después ejecuta `/mcp` dentro de Claude Code y elige InstantClips para iniciar sesión.
+
 ### Codex
 
 Añade lo siguiente a `~/.codex/config.toml`; la configuración se aplica a la CLI, la aplicación y
@@ -52,13 +79,59 @@ la extensión del IDE:
 ```toml
 [mcp_servers.instantclips]
 url = "https://app.instantclips.ai/mcp"
+```
+
+Después ejecuta `codex mcp login instantclips` para iniciar sesión.
+
+### Cursor y VS Code
+
+La [página de configuración](https://app.instantclips.ai/mcp) incluye botones de instalación de un
+clic. Abren la aplicación, añaden InstantClips y te piden iniciar sesión la primera vez.
+
+### Aplicación de Claude y ChatGPT
+
+Aplicación de Claude: añade un conector personalizado con esta dirección e inicia sesión cuando te
+lo pida. ChatGPT en la web: activa el modo de desarrollador en Ajustes, Apps, Avanzado y añade la
+dirección como conector; en un espacio de trabajo Business o Enterprise, un administrador la
+publica como aplicación para todo el equipo. La aplicación de escritorio de ChatGPT acepta la misma
+dirección en Ajustes, Servidores MCP, y la comparte con Codex.
+
+### Cualquier otro cliente o agente MCP
+
+OpenClaw, Hermes o un agente que hayas creado: conéctalo a la dirección mediante Streamable HTTP.
+El servidor anuncia su flujo de inicio de sesión de la forma estándar, así que un cliente que siga
+la especificación no necesita nada más. Lo que no pueda abrir una página de inicio de sesión usa un
+token, como se explica a continuación.
+
+### ¿Sin navegador? Usa un token de acceso
+
+Los scripts, los trabajos de CI y los agentes que no pueden abrir una página de inicio de sesión se
+autentican con un token de larga duración. Genera uno en
+**[app.instantclips.ai/settings#ai-access](https://app.instantclips.ai/settings#ai-access)**. Da
+acceso completo a tu cuenta, así que mantenlo fuera de cualquier cosa que subas a un repositorio.
+
+Con un token, los mismos clientes quedan así:
+
+```bash
+# Claude Code
+claude mcp add --transport http instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"
+```
+
+```toml
+# Codex, en ~/.codex/config.toml
+[mcp_servers.instantclips]
+url = "https://app.instantclips.ai/mcp"
 http_headers = { Authorization = "Bearer YOUR_TOKEN" }
 ```
 
-Para no guardar el token en el archivo, sustituye el encabezado por
-`bearer_token_env_var = "INSTANTCLIPS_TOKEN"` y expórtalo como variable de entorno en tu shell.
+Para no guardar el token en el archivo de Codex, sustituye el encabezado por
+`bearer_token_env_var = "INSTANTCLIPS_TOKEN"` y expórtalo como variable de entorno en tu shell. La
+aplicación de Claude acepta el token como encabezado de solicitud en el conector (los encabezados
+de solicitud siguen en beta); los conectores de ChatGPT inician sesión mediante el flujo de inicio
+de sesión en lugar de una clave pegada. Cualquier otro cliente envía un encabezado
+`Authorization: Bearer`. El protocolo no contiene nada específico de InstantClips.
 
-### Clientes que solo admiten stdio y procesos sin interfaz
+#### Clientes que solo admiten stdio y procesos sin interfaz
 
 El paquete npm `instantclips-mcp` es un adaptador ligero de stdio a HTTPS. Sirve localmente la
 inicialización y el descubrimiento de herramientas para arrancar rápido y sin credenciales; después
@@ -89,24 +162,23 @@ El token solo se acepta mediante `INSTANTCLIPS_TOKEN`, nunca como argumento de l
 por lo que no aparece en la lista de procesos. Es obligatorio para llamar a una herramienta, pero
 no para `initialize`, `ping` ni `tools/list`. Se requiere Node.js 20 o posterior.
 
-### Cursor y VS Code
+Fotos en este equipo: el adaptador puede subirlas por sí mismo, así que se puede hacer un vídeo
+con archivos que nunca salieron de tu portátil. A través del adaptador, `create_product_from_images`
+acepta `image_paths` (rutas a los archivos, hasta 9, de 8 MB cada uno) en lugar de `image_urls`, y
+`update_product` acepta `add_image_paths`. Los archivos se empaquetan y se envían directamente a
+InstantClips como fotos del producto; no se descarga nada de ningún sitio. Arrastra los archivos a
+un cliente que le pase sus rutas al asistente (Claude Code, Cursor, VS Code, agentes de terminal) y
+di qué quieres crear.
 
-La [página de configuración](https://app.instantclips.ai/settings#ai-access) incluye botones de
-instalación de un clic. Una vez generado el token, los botones lo introducen por ti.
+## Instrucciones para empezar
 
-### Aplicación de Claude y ChatGPT
+Cinco para arrancar. Sustituye el enlace o el nombre del producto.
 
-Estos clientes se conectan mediante su propia configuración de conectores, no mediante un archivo.
-Apunta el conector a `https://app.instantclips.ai/mcp` y autentícate con el mismo token: como
-encabezado de solicitud en Claude y como clave de API en ChatGPT. Los encabezados de solicitud de
-Claude siguen en beta y ChatGPT requiere el modo de desarrollador; su disponibilidad depende de tu
-cuenta y de las políticas de tu espacio de trabajo.
-
-### Cualquier otro cliente
-
-OpenClaw, Hermes o un agente que hayas creado: conéctalo a la URL mediante Streamable HTTP con un
-encabezado `Authorization: Bearer`. El protocolo no contiene nada específico de InstantClips, por
-lo que cualquier cliente compatible con MCP ya puede comunicarse con el servidor.
+1. «Haz un anuncio en vídeo para este producto: [URL]»
+2. «Importa todos los productos de esta página de colección y prepara los planes de todos. No generes nada todavía.»
+3. «Muéstrame el plan de [producto] y reescribe el gancho para que empiece por el precio.»
+4. «Haz tres vídeos de [URL] con tres ganchos distintos, para que pueda probarlos.»
+5. «¿A cuál de mis marcas pertenece este producto? Luego haz el vídeo.»
 
 ## Herramientas
 
@@ -115,14 +187,20 @@ El flujo de trabajo, en orden:
 1. **Importar** — usa `import_product_from_url` para una página de tienda o
    `create_product_from_images` cuando no haya una página que leer.
 2. **Esperar el borrador** — consulta `get_product` periódicamente hasta que terminen la importación
-   y la preparación de la dirección creativa.
-3. **Revisarlo y orientarlo** — la dirección se devuelve como texto: gancho, enfoque del contenido,
-   formato, pautas de ejecución y restricciones. `update_video_direction` permite editarla y
+   y la preparación del plan.
+3. **Revisarlo y orientarlo** — el plan se devuelve como texto: gancho, enfoque del contenido,
+   formato, pautas de ejecución y restricciones. `update_video_direction` permite editarlo y
    `redraft_video_direction` propone otro enfoque.
-4. **Renderizar** — usa `generate_video`.
+4. **Generar** — usa `generate_video` pasando `expected_credit_cost`: el coste que se le indicó al
+   usuario, tal como lo informó `get_product`. Si no coincide, se rechaza sin cobrar.
 5. **Recoger el resultado** — consulta `get_video` periódicamente para obtener el MP4 terminado y
    un enlace público para compartirlo.
 
+Otro vídeo del mismo producto sigue el mismo flujo sobre ese producto: editar o volver a preparar el
+plan abre el borrador del siguiente vídeo, y `generate_video` sin borrador genera otra toma del último
+plan. Un vídeo ya generado no se puede modificar. Cada respuesta de `get_product` incluye `next_step`:
+qué hacer a continuación.
+
 Las marcas funcionan de la misma manera: `list_brands`, `create_brand`, `set_product_brand`. Cada
 vídeo se prepara con la voz de una marca; por eso, si el escaparate de un producto importado no
 coincide con ninguna marca existente, el proceso se detiene y pregunta en lugar de adivinar.
@@ -136,15 +214,17 @@ quieras imprimir específicamente los esquemas actuales mediante HTTP.
 
 ## Créditos
 
-Importar un producto, preparar la dirección creativa y editarla es **gratis**. `generate_video` es
-la única herramienta que consume créditos y requiere tu autorización explícita; las herramientas
-indican antes el coste. Un agente no puede acumular cargos sin avisarte. Consulta los
+Importar un producto, preparar el plan y editarlo es **gratis**. `generate_video` es la única
+herramienta que consume créditos y requiere tu autorización explícita; las herramientas indican
+antes el coste, y `generate_video` recibe ese número como `expected_credit_cost`, rechazando un
+lanzamiento cuyo coste haya cambiado. Un agente no puede acumular cargos sin avisarte. Consulta los
 [precios](https://instantclips.ai/#pricing).
 
 ## example.py
 
 Un cliente MCP sin dependencias: solo requiere Python 3.9 o posterior y la biblioteca estándar; no
-hace falta ejecutar `pip install`.
+hace falta ejecutar `pip install`. Se autentica con un token, porque un script no tiene navegador
+con el que iniciar sesión.
 
 ```bash
 export INSTANTCLIPS_TOKEN="your-token"
@@ -158,9 +238,10 @@ es lo que necesitas antes de automatizar el flujo de trabajo descrito arriba.
 
 ## Enlaces
 
-- [instantclips.ai/automate](https://instantclips.ai/automate/) — qué es la automatización y para
-  qué sirve. No repite la configuración; esa información está en este archivo y en la página de
-  configuración de la aplicación.
+- [instantclips.ai/automate](https://instantclips.ai/automate/) — para qué sirve la
+  automatización: un resultado real hecho a partir de una página de tienda, instrucciones para
+  empezar, las herramientas en orden y las reglas. No repite la configuración; esa información está
+  en este archivo y en la página de configuración de la aplicación.
 - [app.instantclips.ai/llms.txt](https://app.instantclips.ai/llms.txt) — descripción del producto y
   de la secuencia de herramientas en un formato legible por máquinas.
 - [Términos](https://app.instantclips.ai/terms) · [Privacidad](https://app.instantclips.ai/privacy)
@@ -187,6 +268,20 @@ de nombres de marca `ai.instantclips`; no lo sustituyas por un nombre `io.github
 firma no se guarda en el repositorio: `.gitignore` cubre `*.pem`, y una clave privada incluida en un
 commit es una clave publicada.
 
+Inicia sesión justo antes de publicar — el token del registro caduca en menos de una hora — y el
+dominio se verifica por HTTP, no por DNS: `instantclips.ai/.well-known/mcp-registry-auth`, en el
+sitio de marketing, sirve la mitad pública de esta clave (`v=MCPv1; k=ed25519; p=…`); no hay
+registro TXT, así que `login dns` falla con "no MCP public key found".
+
+```bash
+mcp-publisher login http --domain instantclips.ai \
+  --private-key "$(openssl pkey -in key.pem -text -noout | awk '/priv:/{f=1;next} /pub:/{f=0} f' | tr -d ' :\n')"
+mcp-publisher publish
+```
+
+`test/shim.test.js` fija la versión del servidor de la instantánea y la `version` de `server.json`;
+cada publicación actualiza ambas.
+
 `glama.json` es el archivo independiente y específico de Glama que permite reclamar allí la ficha.
 Un servidor perteneciente a una organización, en lugar de una cuenta personal, solo puede
 reclamarse si ese archivo está presente.

package/README.md

@@ -2,10 +2,29 @@
 
 **English** · [Español](README.es.md) · [简体中文](README.zh-CN.md)
 
+[![M8ven Verified](https://m8ven.ai/badge/mcp/instantclips-mcp-1k56q7?variant=verified)](https://m8ven.ai/mcp/instantclips-mcp-1k56q7)
+
 [InstantClips](https://instantclips.ai) turns an e-commerce product into short-form vertical
 video for TikTok, Instagram Reels and Stories. It runs a hosted **MCP server**, so Claude Code,
 Codex, Cursor, VS Code, the Claude app, ChatGPT or any other MCP client can do what the web app
-does: import a product, draft the creative direction, and render the video.
+does: import a product, draft the plan, and generate the video.
+
+**This is not a text-to-video generator.** InstantClips reads the product page — photos, price,
+details — and builds the ad from what is actually there. The plan is written first and shown to
+you; the video follows the plan. That is why it is cheap enough to run across a catalogue, and why
+the result is the product you sell rather than a guess at it.
+
+Free to start: the welcome credits cover the first video, and there is no card to enter. After
+that, one-time credit packs, or an Agency membership for anyone running several brands. See
+[pricing](https://instantclips.ai/#pricing).
+
+- **Where it fits.** Beside a scheduler (Postiz, Buffer) that posts what comes back. Beside an
+  attribution tool that tells you which hook worked. Instead of an editor when you have a product
+  page and no footage.
+- **Not for.** Cinematic hero films. A presenter reading your script. Horizontal 4K. Products with
+  no page and no photos.
+- **Built for.** Shopify sellers, dropshippers, brands and agencies running social for several
+  stores at once.
 
 **The product server stays hosted.** This repository contains its connection guide, registry
 metadata, example HTTP client and a small open-source stdio adapter for clients that cannot connect
@@ -15,31 +34,38 @@ remains the source of truth; the product implementation is not duplicated here.
 
 ## Endpoint
 
-|            |                                            |
-| ---------- | ------------------------------------------ |
-| Endpoint   | `https://app.instantclips.ai/mcp`          |
-| Transport  | Streamable HTTP, stateless                 |
-| Method     | `POST`, JSON-RPC 2.0                       |
-| Auth       | `Authorization: Bearer <token>`            |
+|            |                                                                                   |
+| ---------- | --------------------------------------------------------------------------------- |
+| Endpoint   | `https://app.instantclips.ai/mcp`                                                 |
+| Transport  | Streamable HTTP, stateless                                                        |
+| Method     | `POST`, JSON-RPC 2.0                                                              |
+| Auth       | Sign in when your client asks (OAuth 2.1), or `Authorization: Bearer <token>` for callers with no browser |
 
-Mint a token at **[app.instantclips.ai/settings#ai-access](https://app.instantclips.ai/settings#ai-access)**.
-The token is a handle on your own account: same brands, products, credits and plan limits as the
-web app. Signing in creates an account if you do not have one, with free credits to start.
+Paste one address into your assistant and sign in when it asks. That is the whole setup. The
+first time it calls, the server sends you to sign in to InstantClips and approve the assistant;
+there are no keys to copy. Every assistant you approve is listed under **Authorized apps** in
+settings, where you can disconnect it.
 
-Opening the endpoint in a browser returns the setup page rather than a protocol error, with
-one-click install buttons that fill your token in for you.
+The connection is to your own account: same brands, products, credits and plan limits as the web
+app. Signing in creates an account if you do not have one, with credits for the first video.
+
+Opening the endpoint in a browser returns the [setup page](https://app.instantclips.ai/mcp)
+rather than a protocol error, with one-click install buttons for Cursor and VS Code.
 
 ## Install
 
-Connect to the hosted endpoint directly whenever your client supports Streamable HTTP. Use the
-stdio adapter below only for clients and automated runners that require a local command.
+Connect to the hosted endpoint directly whenever your client supports Streamable HTTP; it takes
+you through sign-in on first use. Use a token and the stdio adapter (under "No browser?" below)
+only for scripts and automated runners that cannot open a sign-in page.
 
 ### Claude Code
 
 ```bash
-claude mcp add --transport http instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"
+claude mcp add --transport http instantclips https://app.instantclips.ai/mcp
 ```
 
+Then run `/mcp` inside Claude Code and choose InstantClips to sign in.
+
 ### Codex
 
 Add to `~/.codex/config.toml`, which covers the CLI, the app and the IDE extension together:
@@ -47,13 +73,56 @@ Add to `~/.codex/config.toml`, which covers the CLI, the app and the IDE extensi
 ```toml
 [mcp_servers.instantclips]
 url = "https://app.instantclips.ai/mcp"
+```
+
+Then run `codex mcp login instantclips` to sign in.
+
+### Cursor and VS Code
+
+One-click install buttons are on the [setup page](https://app.instantclips.ai/mcp). They open
+the app, add InstantClips, and sign you in on first use.
+
+### Claude app and ChatGPT
+
+Claude app: add a custom connector with this address and sign in when it asks. ChatGPT on the
+web: turn on Developer mode under Settings, Apps, Advanced, then add the address as a connector;
+on a Business or Enterprise workspace an admin publishes it as an app for everyone instead. The
+ChatGPT desktop app takes the same address under Settings, MCP servers, and shares it with Codex.
+
+### Any other MCP client or agent
+
+OpenClaw, Hermes, or an agent you wrote yourself: point it at the address over Streamable HTTP.
+The server announces its sign-in flow the standard way, so a client that follows the spec needs
+nothing else. Anything that cannot open a sign-in page uses a token instead, below.
+
+### No browser? Use an access token
+
+Scripts, CI jobs and agents that cannot open a sign-in page authenticate with a long-lived token
+instead. Mint one at
+**[app.instantclips.ai/settings#ai-access](https://app.instantclips.ai/settings#ai-access)**. It
+gives full access to your account, so keep it out of anything you commit.
+
+With a token, the same clients look like this:
+
+```bash
+# Claude Code
+claude mcp add --transport http instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"
+```
+
+```toml
+# Codex, in ~/.codex/config.toml
+[mcp_servers.instantclips]
+url = "https://app.instantclips.ai/mcp"
 http_headers = { Authorization = "Bearer YOUR_TOKEN" }
 ```
 
-To keep the token out of the file, swap the header for `bearer_token_env_var = "INSTANTCLIPS_TOKEN"`
-and export it in your shell instead.
+To keep the token out of the Codex file, swap the header for `bearer_token_env_var = "INSTANTCLIPS_TOKEN"`
+and export it in your shell instead. The Claude app takes a token as a request header on the
+connector (request headers are still in beta); ChatGPT connectors sign in through the sign-in flow
+rather than a pasted key. Any other client sends an `Authorization: Bearer` header. Nothing on the
+wire is InstantClips-specific.
 
-### Stdio-only clients and headless runners
+#### Stdio-only clients and headless runners
 
 The `instantclips-mcp` npm package is a thin stdio-to-HTTPS adapter. It serves initialization and
 tool discovery locally for a fast, credential-free cold start, then reads the token from the
@@ -83,23 +152,22 @@ The token is accepted only through `INSTANTCLIPS_TOKEN`, never as a command-line
 does not appear in the process list. It is required for tool calls, but not for `initialize`,
 `ping`, or `tools/list`. Node.js 20 or newer is required.
 
-### Cursor and VS Code
-
-One-click install buttons are on the [setup page](https://app.instantclips.ai/settings#ai-access).
-They fill in your token once you have minted one.
-
-### Claude app and ChatGPT
+Photos on this machine: the adapter can upload them itself, so a video can be made from files
+that never left your laptop. Through the adapter, `create_product_from_images` takes `image_paths`
+(paths to the files, up to 9, 8 MB each) in place of `image_urls`, and `update_product` takes
+`add_image_paths`. The files are packaged and posted straight to InstantClips as the product's
+photos — nothing is downloaded from anywhere. Drag the files into a client that hands the
+assistant their paths (Claude Code, Cursor, VS Code, terminal agents) and say what you want made.
 
-These connect through their own connector settings rather than a file. Point one at
-`https://app.instantclips.ai/mcp` and authenticate with the same token — a request header in
-Claude, an API key in ChatGPT. Claude's request headers are still in beta, and ChatGPT requires
-developer mode; availability there depends on your account and workspace policy.
+## Starter prompts
 
-### Anything else
+Five to begin with. Swap in a link or a product name.
 
-OpenClaw, Hermes, or an agent you wrote yourself: point it at the URL over streamable HTTP with an
-`Authorization: Bearer` header. Nothing on the wire is InstantClips-specific, so a client that
-speaks MCP already speaks this.
+1. "Make a video ad for this product: [URL]"
+2. "Import every product on this collection page and draft plans for all of them. Don't generate anything yet."
+3. "Show me the plan for [product] and rewrite the hook to lead with the price."
+4. "Make three videos for [URL] with three different hooks, so I can test them."
+5. "Which of my brands is this product for? Then make the video."
 
 ## Tools
 
@@ -107,14 +175,19 @@ The workflow, in order:
 
 1. **Import** — `import_product_from_url` for a store page, or `create_product_from_images` when
    there is no page to read.
-2. **Wait for the draft** — poll `get_product` until the import and the creative direction have
-   finished.
-3. **Read and steer it** — the direction comes back as text: hook, content focus, format,
-   execution guidelines, restrictions. `update_video_direction` edits it, `redraft_video_direction`
-   asks for another angle.
-4. **Render** — `generate_video`.
+2. **Wait for the draft** — poll `get_product` until the import and the plan have finished.
+3. **Read and steer it** — the plan comes back as text: hook, content focus, format, execution
+   guidelines, restrictions. `update_video_direction` edits it, `redraft_video_direction` asks
+   for another angle.
+4. **Generate** — `generate_video`, passing `expected_credit_cost`: the cost the user was told, as
+   `get_product` reported it. A mismatch is refused without charging.
 5. **Collect** — poll `get_video` for the finished MP4 and a public share link.
 
+Another video for the same product is the same flow on that product: editing or redrafting opens the
+next video's draft, and `generate_video` with no draft renders another take of the last plan. A
+generated video itself cannot be changed. Every `get_product` response carries `next_step`: what to
+do now.
+
 Brands work the same way: `list_brands`, `create_brand`, `set_product_brand`. Every video is
 drafted in a brand's voice, so an import whose storefront matches no existing brand stops and asks
 rather than guessing.
@@ -128,14 +201,15 @@ want to print the live schemas over HTTP.
 
 ## Credits
 
-Importing a product, drafting the creative direction and editing it are all **free**.
-`generate_video` is the only tool that spends credits, and it requires your explicit go-ahead — the
-tools report the cost first. An agent cannot quietly run up a bill. See
-[pricing](https://instantclips.ai/#pricing).
+Importing a product, drafting the plan and editing it are all **free**. `generate_video` is the
+only tool that spends credits, and it requires your explicit go-ahead — the tools report the cost
+first, and `generate_video` takes that number back as `expected_credit_cost`, refusing a launch whose
+cost has changed. An agent cannot quietly run up a bill. See [pricing](https://instantclips.ai/#pricing).
 
 ## example.py
 
-A dependency-free MCP client — Python 3.9+, standard library only, no `pip install`.
+A dependency-free MCP client — Python 3.9+, standard library only, no `pip install`. It
+authenticates with a token, since a script has no browser to sign in with.
 
 ```bash
 export INSTANTCLIPS_TOKEN="your-token"
@@ -149,8 +223,9 @@ is what you need before scripting the workflow above.
 
 ## Links
 
-- [instantclips.ai/automate](https://instantclips.ai/automate/) — what the automation is and what
-  it is for. It does not repeat the setup; this file and the app's setup page are where that lives.
+- [instantclips.ai/automate](https://instantclips.ai/automate/) — what the automation is for: a
+  real result made from a store page, starter prompts, the tools in order, and the rules. It does
+  not repeat the setup; this file and the app's setup page are where that lives.
 - [app.instantclips.ai/llms.txt](https://app.instantclips.ai/llms.txt) — machine-readable
   description of the product and the tool sequence
 - [Terms](https://app.instantclips.ai/terms) · [Privacy](https://app.instantclips.ai/privacy)
@@ -174,6 +249,20 @@ Publish the npm package first, then re-publish this same registry entry with
 `ai.instantclips` namespace; do not replace it with an `io.github.*` name. The signing key stays out
 of the repository — `.gitignore` covers `*.pem`, and a committed private key is a published one.
 
+Log in right before publishing — the registry token expires within the hour — and the domain is
+verified over HTTP, not DNS: `instantclips.ai/.well-known/mcp-registry-auth` on the marketing site
+serves this key's public half (`v=MCPv1; k=ed25519; p=…`), and there is no TXT record, so
+`login dns` fails with "no MCP public key found".
+
+```bash
+mcp-publisher login http --domain instantclips.ai \
+  --private-key "$(openssl pkey -in key.pem -text -noout | awk '/priv:/{f=1;next} /pub:/{f=0} f' | tr -d ' :\n')"
+mcp-publisher publish
+```
+
+`test/shim.test.js` pins the snapshot's server version and `server.json`'s `version`; a release
+moves both.
+
 `glama.json` is the separate, Glama-specific file that claims the listing there. A server under an
 organisation rather than a personal account can only be claimed with that file present.
 It carries ownership only. In Glama's Dockerfile form, use build steps