CLI y servidor MCP

Genera desde tu terminal o desde tu agente.

La CLI nolgia es un único binario de Rust para generar imagen, video y audio. El servidor MCP de NOLGIA ofrece la misma plataforma a Claude Code y a cualquier otro agente. Una cuenta, dos formas de entrar.

shell
npm install -g @nolgia/cli
Una joven con un abrigo de piel blanco escribe en un teclado sobre su regazo, sentada en una pila de televisores viejos en un estacionamiento de noche; todas las pantallas muestran la palmera que arde detrás de ella

Instalación

Elige tu gestor de paquetes.

Un binario, cuatro formas de obtenerlo. Todos los canales siguen la misma versión.

shell
npm install -g @nolgia/cli

Instala el binario precompilado para tu plataforma. Requiere Node 18+.

Pega esto en tu agente

una línea
Read https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md and follow it end to end to install and set up the Nolgia CLI for me.

Tu agente de programación instala la CLI sin sudo, espera mientras te autenticas, instala las skills y ejecuta una generación de verificación.

Lee el runbook

Inicio rápido

Autentícate y genera.

Inicia sesión una vez con nolgia auth login y genera con cualquier modelo compatible. Compón secuencias de varias tomas repitiendo la opción --shot y pasa --cost-only para conocer el precio de un trabajo antes de ejecutarlo.

terminal
# Authenticate once: opens a device login in your browser
nolgia auth login

# Generate an 8-second clip from a prompt
nolgia gen video \
  --model veo-3.1 \
  --prompt "a street bike carving a coastal road at dusk" \
  --duration-seconds 8 \
  --out clip.mp4
multi-shot
# Direct a multi-shot sequence: one --shot per beat.
# Add --cost-only first to see the credit estimate before spending.
nolgia gen video \
  --model veo-3.1 \
  --shot "8:WIDE SHOT: city skyline at golden hour, slow push in" \
  --shot "6:MEDIUM SHOT: rider mounts the bike, engine catches" \
  --shot "8:CLOSE UP: throttle twists, headlight flares" \
  --out sequence.mp4 \
  --cost-only
Calcula el precio primero
nolgia gen video --model veo-3.1 --prompt "…" --cost-only

El endpoint POST /jobs/cost de la API devuelve la misma cifra.

Hecho para quienes viven en la terminal.

Sin paneles que vigilar. Todo lo que hace Studio está a un comando o a una llamada de herramienta.

Un cliente para personas y agentes

Un cliente para personas y agentes

La misma plataforma detrás de la terminal y del servidor MCP. Escribe tus scripts a mano o deja que Claude Code la maneje. Las capacidades son idénticas.

Precios en créditos transparentes

Precios en créditos transparentes

Agrega --cost-only a cualquier generación para obtener una estimación en créditos antes de gastar. Sin cobros sorpresa ni multiplicadores ocultos.

Modelo de trabajos asíncronos

Modelo de trabajos asíncronos

Cada generación es un trabajo que puedes esperar o consultar. Lanza un lote, olvídate y recoge los resultados cuando lleguen.

Secuencias nativas de varias tomas

Secuencias nativas de varias tomas

Compón secuencias cinematográficas repitiendo la opción --shot. Dirige tomas abiertas, medias y primeros planos en un solo comando.

Imagen a video en todas partes

Imagen a video en todas partes

Genera video a partir de una imagen fija en cada modelo compatible, con el mismo conjunto de opciones.

Funciona en Claude Code

Funciona en Claude Code

Apunta cualquier cliente MCP al servidor alojado con un token bearer y todas las herramientas aparecerán en tu agente.

Servidor MCP

Dale a tu agente toda la plataforma.

El servidor MCP de NOLGIA está alojado en https://mcp.nolgia.ai/mcp y usa el transporte Streamable HTTP de MCP. Autentícate con un PAT o un JWT como bearer y las 81 herramientas quedan disponibles para Claude Code, Cursor o cualquier cliente MCP que pueda enviar un encabezado. Los asistentes que te piden iniciar sesión en lugar de un token se explican en la página de MCP.

mcp.json
{
  "mcpServers": {
    "nolgia": {
      "url": "https://mcp.nolgia.ai/mcp",
      "headers": {
        "Authorization": "Bearer nol_your_token_here"
      }
    }
  }
}

Genera un token de acceso personal desde tu cuenta y ponlo en el encabezado Authorization. Reinicia tu cliente para que detecte el servidor.

81 herramientas, leídas del propio registro del servidor

Generate

Generate: 17 herramientas
HerramientaFunción
nolgia_text_to_imageGenerate image from text
nolgia_image_to_imageGenerate image from an image
nolgia_text_to_videoGenerate video from text
nolgia_image_to_videoAnimate an image into video
nolgia_text_to_audioGenerate audio from text
nolgia_run_presetRun a preset
nolgia_render_blocksAssemble clips and narration into one video
nolgia_multicam_planPlan a Multicam job
nolgia_multicam_startStart a Multicam job
nolgia_multicam_runCheck a Multicam job
nolgia_multicam_downloadDownload every Multicam angle
nolgia_multicam_cancelStop a Multicam job
nolgia_generate_3dGenerate a 3D model
nolgia_generate_setGenerate a set of images
nolgia_miroge_optionsPrice a Miroge remake
nolgia_mirogeRemake a clip with Miroge
nolgia_analyze_referenceAnalyze a reference video

Your library

Your library: 25 herramientas
HerramientaFunción
nolgia_list_assetsList generated assets
nolgia_get_assetOpen an asset
nolgia_delete_assetTrash an asset
nolgia_update_asset_tagsSet an asset's tags
nolgia_upload_assetUpload an image
nolgia_list_charactersList saved characters
nolgia_get_characterGet one character
nolgia_create_characterSave a character
nolgia_update_characterUpdate a character
nolgia_delete_characterDelete a character
nolgia_list_stylesList saved styles
nolgia_create_styleSave a style
nolgia_delete_styleDelete a saved style
nolgia_transcribe_assetTranscribe an asset
nolgia_get_transcriptGet an asset transcript
nolgia_suggest_clipsFind short video clips
nolgia_create_clipsCreate short video clips
nolgia_get_setGet a set of images
nolgia_get_mirogeCheck a Miroge remake
nolgia_get_reference_analysisRead a reference analysis
nolgia_apply_lookApply a look to generations
nolgia_look_from_analysisMake a look from a reference analysis
nolgia_merge_look_analysesTeach a look from several videos
nolgia_match_lookRe-cut a timeline to a look
nolgia_score_edit_dnaScore a render against a look

Projects

Projects: 11 herramientas
HerramientaFunción
nolgia_list_projectsList projects
nolgia_get_projectGet one project
nolgia_create_projectCreate a project
nolgia_update_projectUpdate a project
nolgia_delete_projectDelete a project
nolgia_add_project_assetsAdd assets to a project
nolgia_remove_project_assetRemove an asset from a project
nolgia_list_canvasesList canvases
nolgia_get_canvasGet a canvas
nolgia_create_canvasCreate a canvas
nolgia_update_canvasUpdate a canvas

Edit sessions and tweaks

Edit sessions and tweaks: 6 herramientas
HerramientaFunción
nolgia_list_tweak_scopesList image tweak scopes
nolgia_create_edit_sessionStart an edit session
nolgia_get_edit_sessionRead an edit session
nolgia_edit_session_stepApply the next image edit
nolgia_revert_edit_sessionRevert an edit session
nolgia_estimate_edit_sessionEstimate the next edit

Presets

Presets: 2 herramientas
HerramientaFunción
nolgia_list_presetsList presets
nolgia_get_presetGet one preset

Timelines

Timelines: 4 herramientas
HerramientaFunción
nolgia_validate_maskValidate a timeline mask
nolgia_validate_motionValidate timeline motion
nolgia_list_color_presetsList color-grade presets
nolgia_get_renderCheck a render

Desktop apps

Desktop apps: 11 herramientas
HerramientaFunción
nolgia_app_statusList connected desktop apps
nolgia_app_infoRead a desktop app's state
nolgia_app_runRun code in a desktop app
nolgia_app_commandCheck a desktop app command
nolgia_app_previewPreview a desktop app's document
nolgia_app_importImport an asset into a desktop app
nolgia_app_exportExport from a desktop app
nolgia_app_saveSave the document in a desktop app
nolgia_app_openOpen a document in a desktop app
nolgia_app_ditDo the DIT on the person's computer
nolgia_app_transcribeTranscribe clips in Premiere Pro

Models, account and jobs

Models, account and jobs: 5 herramientas
HerramientaFunción
nolgia_list_modelsList models
nolgia_get_accountGet the signed-in account
nolgia_get_usageGet generation counts
nolgia_cancel_jobCancel a generation job
nolgia_list_jobsList generation jobs

Modelos

Los modelos que usa la CLI.

imagen

GPT Image 2.5 Sunburst

desde 8 créditos por imagen

Ver el modelo

audio

ElevenLabs v3 Conversational

desde 3 créditos por cada 1000 caracteres

Ver el modelo
Explora todos los modelos

FAQ

Preguntas desde la terminal.

¿Cómo instalo la CLI de nolgia?
Con npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) y curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Todos los canales siguen la misma versión.
¿Cómo inicio sesión desde la terminal?
Ejecuta nolgia auth login una vez. Abre un inicio de sesión de dispositivo en tu navegador y la CLI conserva la sesión.
¿Puedo ver cuánto cuesta un trabajo antes de ejecutarlo?
Sí. Agrega --cost-only a cualquier generación para obtener el estimado de créditos sin gastar nada.
¿Qué puede generar la CLI?
Imágenes, video y audio con los modelos que publica la plataforma, incluidas secuencias de video de varias tomas con flags --shot repetidos y video a partir de una imagen fija.
¿Cómo conecto Claude Code u otro agente?
Apunta tu cliente MCP a https://mcp.nolgia.ai/mcp con un encabezado Authorization: Bearer que lleve un token de acceso personal, y las 81 herramientas aparecen en tu agente.
¿La CLI y la app comparten créditos?
Cuando inicias sesión con nolgia auth login, sí: la CLI gasta primero los créditos mensuales de tu plan y luego los de tus recargas, igual que la app. Un token de acceso personal (NOLGIA_TOKEN), que también usan la API y el servidor MCP, gasta solo los créditos de recargas. Un asistente que conectas por OAuth, como ChatGPT o Claude, gasta igual que la app.
¿Mi agente de programación puede configurarme la CLI?
Sí. Copia la instrucción de una línea en Pega esto en tu agente. Dirige a tu agente de programación al runbook de instalación en https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, que recorre la instalación, la autenticación, las skills y una generación de verificación.
¿Cómo veo cuánto va a costar un trabajo?
Usa --cost-only en la CLI o POST /jobs/cost en la API. Ambos usan el mismo calculador de precios y devuelven el mismo estimado de créditos antes de generar.

Conecta un agente.

Crea una cuenta, genera un token y apunta tu CLI o tu cliente MCP a NOLGIA. Los primeros créditos corren por nuestra cuenta.