@image-mcp/cli
v0.1.6
Published
Agent-first CLI for Image MCP image generation, editing, jobs, and skill install flows
Maintainers
Readme
@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/cliOr run it directly:
npx --yes @image-mcp/cli --helpQuick Start
image-mcp login
image-mcp whoami
image-mcp models --limit 5
image-mcp create "studio product shot" --model nano-banana-2
image-mcp skill install --agent allCanonical Model IDs
Use provider-neutral public ids:
nano-banananano-banana/editnano-banana-2nano-banana-2/edit
Slash-style edit ids are canonical.
Main Commands
loginlogoutwhoamimodelsactivityuploadcreateeditjob get|list|wait|canceldoctorskill 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.comIf you are using npx without a global install:
npx --yes @image-mcp/cli login
npx --yes @image-mcp/cli --help
npx --yes @image-mcp/cli whoamiPer-command help also works as:
image-mcp help create
image-mcp help job waitProduct Surfaces
Image MCP ships four product surfaces:
- CLI
- Skill
- JSON API
- MCP
For most agent workflows, the CLI + skill path is the best default.
