@image-mcp/cli

@image-mcp/cli

Agent-first CLI for Image MCP.

This package gives agents and humans a direct workflow surface for:

• browser OAuth login
• model discovery
• uploads
• image create and edit jobs
• job polling and cancellation
• local skill installation

Install

npm install -g @image-mcp/cli

Or run it directly:

npx --yes --package=@image-mcp/cli image-mcp --help

Quick Start

image-mcp login
image-mcp models --limit 5
image-mcp create "studio product shot" --model nano-banana-2
image-mcp skill install --agent all

Canonical Model IDs

Use provider-neutral public ids:

• nano-banana
• nano-banana/edit
• nano-banana-2
• nano-banana-2/edit

Slash-style edit ids are canonical.

Main Commands

• login
• logout
• whoami
• models
• activity
• upload
• create
• edit
• job get|list|wait|cancel
• doctor
• skill install

Auth

The default flow opens the browser for OAuth and stores a local session. You can also point the CLI at another deployment with:

image-mcp whoami --base-url https://image-mcp.com

If you are using npx without a global install, use the explicit package form because the published package name and executable name differ:

npx --yes --package=@image-mcp/cli image-mcp --help
npx --yes --package=@image-mcp/cli image-mcp whoami

Product Surfaces

Image MCP ships four product surfaces:

• CLI
• Skill
• JSON API
• MCP

For most agent workflows, the CLI + skill path is the best default.