instantclips-mcp 1.1.0 → 1.3.0

package/README.es.md

@@ -2,47 +2,75 @@
 
 [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
-para los clientes que no pueden conectarse directamente a un servidor remoto. El adaptador se
-limita a transportar mensajes MCP al endpoint alojado; las definiciones de las herramientas y la
-implementación del producto permanecen en un único lugar.
+para los clientes que no pueden conectarse directamente a un servidor remoto. El adaptador responde
+localmente a la inicialización, al ping y al descubrimiento de herramientas desde una instantánea
+generada, y envía al endpoint alojado únicamente las llamadas autenticadas. El servidor alojado
+sigue siendo la fuente de verdad; la implementación del producto no se duplica aquí.
 
 ## 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
@@ -51,16 +79,63 @@ 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. Lee el token del entorno,
-fija InstantClips como endpoint de destino y reenvía el protocolo sin modificarlo:
+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
+lee el token del entorno y envía las llamadas de herramientas a InstantClips:
 
 ```json
 {
@@ -84,26 +159,18 @@ INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json
 ```
 
 El token solo se acepta mediante `INSTANTCLIPS_TOKEN`, nunca como argumento de línea de comandos,
-por lo que no aparece en la lista de procesos. Se requiere Node.js 20 o posterior.
-
-### Cursor y VS Code
+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.
 
-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
 
@@ -112,34 +179,44 @@ 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.
 
-El propio servidor publica los parámetros exactos de cada herramienta. Este repositorio no los
-repite deliberadamente: ejecuta `python example.py tools`, como se indica abajo, para mostrar los
-esquemas actuales. Así, lo que construyas no puede quedar desfasado respecto a lo que acepta el
-servidor.
+El servidor alojado publica los parámetros exactos de cada herramienta. La instantánea generada
+[`manifest/instantclips-mcp.json`](manifest/instantclips-mcp.json) permite que clientes stdio y
+registros inspeccionen los mismos esquemas sin credenciales. Quienes mantienen el repositorio la
+actualizan con `INSTANTCLIPS_TOKEN="..." npm run sync:manifest`; `npm run check:manifest` falla si
+la copia incluida difiere del servidor en producción. Ejecuta `python example.py tools` cuando
+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"
@@ -153,9 +230,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)
@@ -185,9 +263,12 @@ commit es una clave publicada.
 `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.
-El archivo solo acredita la propiedad: configura `npm ci` como compilación en Glama, ejecuta
-`node bin/instantclips-mcp.js` y proporciona `INSTANTCLIPS_TOKEN` como secreto desde la interfaz de
-administración del servidor.
+El archivo solo acredita la propiedad. En el formulario Dockerfile de Glama, usa
+`["npm install --omit=dev"]` como pasos de compilación,
+`["node", "./bin/instantclips-mcp.js"]` como argumentos de CMD y cualquier valor ficticio para el
+marcador obligatorio `INSTANTCLIPS_TOKEN`. Las comprobaciones de inicialización y calidad de Glama
+usan el manifiesto incluido y nunca envían ese valor al servidor alojado. No introduzcas un token
+real de una cuenta en el entorno de compilación de un tercero.
 
 ## Licencia
 

package/README.md

@@ -2,43 +2,70 @@
 
 **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
-to a remote server directly. The adapter only carries MCP messages to the hosted endpoint; the
-tool definitions and product implementation remain in one place.
+to a remote server directly. The adapter answers initialization, ping and tool discovery from a
+generated snapshot, then sends authenticated tool calls to the hosted endpoint. The hosted server
+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:
@@ -46,16 +73,60 @@ 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 reads the token from the
-environment, fixes the upstream endpoint to InstantClips and forwards the protocol unchanged:
+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
+environment and sends tool calls to InstantClips:
 
 ```json
 {
@@ -78,25 +149,18 @@ INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json
 ```
 
 The token is accepted only through `INSTANTCLIPS_TOKEN`, never as a command-line argument, so it
-does not appear in the process list. Node.js 20 or newer is required.
+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
+## Starter prompts
 
-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
+Five to begin with. Swap in a link or a product name.
 
-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.
-
-### Anything else
-
-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
 
@@ -104,32 +168,41 @@ 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.
 
-Each tool's exact parameters are published by the server itself. This repository deliberately does
-not restate them — run `python example.py tools` below to print the live schemas, so what you build
-against cannot drift from what the server accepts.
+Each tool's exact parameters are published by the hosted server. The generated
+[`manifest/instantclips-mcp.json`](manifest/instantclips-mcp.json) snapshot lets stdio clients and
+registries inspect those same schemas without a credential. Maintainers refresh it with
+`INSTANTCLIPS_TOKEN="..." npm run sync:manifest`; `npm run check:manifest` fails when the committed
+snapshot differs from the live server. Run `python example.py tools` below when you specifically
+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"
@@ -143,8 +216,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)
@@ -170,8 +244,11 @@ of the repository — `.gitignore` covers `*.pem`, and a committed private key i
 
 `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: configure Glama's build as `npm ci`, run
-`node bin/instantclips-mcp.js`, and supply `INSTANTCLIPS_TOKEN` as a secret in the server admin UI.
+It carries ownership only. In Glama's Dockerfile form, use build steps
+`["npm install --omit=dev"]`, CMD arguments `["node", "./bin/instantclips-mcp.js"]`, and any dummy
+value for the required `INSTANTCLIPS_TOKEN` placeholder. Glama's initialization and tool-quality
+checks use the bundled manifest and never transmit that placeholder upstream. Do not put a real
+account token into a third-party build sandbox.
 
 ## License