CLI

Command-line client for StirVid and its MCP server.

The StirVid CLI ships in the same package as the MCP server. It runs the local stdio server, calls the hosted MCP endpoint, and mirrors every MCP tool as a command.

Install

npm install -g ./mcp

Log in

stirvid login <key>

The key is stored in the system keychain and used as the Bearer token for hosted MCP calls.

Common commands

# Account
stirvid balance
stirvid status
stirvid ledger --limit 20

# Content
stirvid characters
stirvid generate <image_url> <video_url> --mode std
stirvid task <task_id>

# Ops
stirvid record-funding --amount 100 --source manual_topup

# Servers
stirvid mcp             # start stdio MCP server
stirvid serve --port 8791   # start HTTP MCP server on :8791

# Diagnostics
stirvid doctor

stirvid doctor

doctor runs the same suite as ops-health-check:

• Verifies the API key
• Pings the Control API and hosted MCP endpoint
• Reads the generation-account balance and warns below thresholds
• Prints active plan and current credit balance

Run stirvid doctor first when triaging any 401, 402, or generation failure.