NOLGIA

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 tokenConnect 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 the hosted server 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 https://mcp.nolgia.ai/mcp and speaks the MCP Streamable HTTP transport. Authenticate with a bearer PAT or JWT and all 29 tools become available to Claude Code, Cursor, or any MCP client that can send a header. Assistants that sign you in instead of taking a token are covered on the MCP page.

Configuration

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

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

Tools (12)

  • nolgia_list_modelsList every model, its capabilities and its credit cost.
  • 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.

FAQ

Questions from the terminal.

How do I install the nolgia CLI?
With npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli), and curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). All channels track the same release.
How do I sign in from the terminal?
Run nolgia auth login once. It opens a device login in your browser and the CLI keeps the session.
Can I see what a job costs before I run it?
Yes. Add --cost-only to any generation to get the credit estimate without spending anything.
What can the CLI generate?
Images, video and audio on the models the platform publishes, including multi-shot video sequences from repeated --shot flags and video from a still image.
How do I connect Claude Code or another agent?
Point your MCP client at https://mcp.nolgia.ai/mcp with an Authorization: Bearer header carrying a personal access token, and all 29 tools show up in your agent.
Do the CLI and the app share credits?
Yes. One account, one credit balance: the CLI, the MCP server and the app all draw on it.

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 · freeView pricing