CLI & MCP Server

Generate from your terminal, or from your agent.

The nolgia CLI is a single Rust binary for image, video, and audio generation. The NOLGIA MCP server exposes the same platform to Claude Code and any other agent. One account, one credit balance, two ways in.

$npm install -g @nolgia/cli

Get an access token Connect an agent

Built for people who live in the terminal.

No dashboards to babysit. Everything the Studio can do is a command or a tool call away.

One client for humans and agents

The same platform behind the terminal and the MCP server. Script it by hand, or let Claude Code drive it. The capabilities are identical.

Transparent credit pricing

Add --cost-only to any generation to get a credit estimate before you spend. No surprise metering, no hidden multipliers.

Async job model

Every generation is a job you can wait on or poll. Fire a batch, walk away, and collect the outputs when they land.

Native multi-shot sequences

Compose cinematic sequences from repeated --shot flags. Direct wide, medium, and close-up beats in a single command.

Image-to-video everywhere

Drive video from a still on every capable model with one consistent flag set.

Works in Claude Code

Point any MCP client at mcp.nolgia.ai with a bearer token and the full tool surface shows up in your agent.

Quick start

Authenticate, then generate.

Log in once with nolgia auth login, then generate against any supported model. Compose multi-shot sequences with repeated --shot flags, and pass --cost-only to price a job before you run it.

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

Install

Pick your package manager.

One binary, four ways to get it. All channels track the same release.

$npm install -g @nolgia/cli

Installs the prebuilt binary for your platform. Requires Node 18+.

MCP server

Give your agent the whole platform.

The NOLGIA MCP server is hosted at mcp.nolgia.ai. Authenticate with a bearer PAT or JWT and every generation, asset, and account tool becomes available to Claude Code, Claude Desktop, or any MCP-compatible client.

Configuration

mcp.json

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

Generate a personal access token from your account, then drop it into the Authorization header. Restart your client to pick up the server.

Tools (11)

nolgia_text_to_imageGenerate an image from a prompt.
nolgia_image_to_imageTransform a source image with a prompt.
nolgia_text_to_videoGenerate video from a prompt, including multi-shot.
nolgia_image_to_videoAnimate a still image into video.
nolgia_text_to_audioGenerate audio from a prompt.
nolgia_list_assetsList assets in your library.
nolgia_get_assetFetch a single asset by id.
nolgia_delete_assetRemove an asset from your library.
nolgia_list_jobsList generation jobs and their status.
nolgia_get_accountRead account details and plan.
nolgia_get_usageReport credit usage and balance.

Connect an agent.

Create an account, mint a token, and point your CLI or MCP client at NOLGIA. The first credits are on us.

Get started · free View pricing