Z.AI CLI

Overview

Z.AI CLI is a single command-line tool that wraps the Z.AI service catalog (image generation, OCR, vision analysis, web search, web reader, and code research via Zread) and exposes the same tools as a Model Context Protocol server for Claude Code. One install, one API key, eight tools.

Features

• Image Generation: Generate images from prompts with quality and size controls
• OCR: Extract text from images and PDFs (URLs or local paths)
• Vision: Ask natural-language questions about images
• Web Search: Query the web with recency and result-count filters
• Web Reader: Fetch and parse web pages into clean text or markdown
• Zread Code Research: Search docs, get repo structure, and read files from any GitHub repo
• MCP Server: All tools exposed to Claude Code with selectable subsets (mcp web, mcp zread, etc.)
• Zero Install: Run via bunx @briansunter/z-cli without installing globally

CLI Usage

# Image generation
bunx @briansunter/z-cli image "a sunset over mountains" --quality hd --size 1280x1280

# OCR: extract text from images and PDFs
bunx @briansunter/z-cli ocr ./document.pdf

# Vision: analyze images
bunx @briansunter/z-cli vision ./photo.png "Describe this image"

# Web search and reader
bunx @briansunter/z-cli search "Claude Code MCP server" --count 5 --recency oneWeek
bunx @briansunter/z-cli read https://bun.com --format text --no-images

# Code research via Zread
bunx @briansunter/z-cli zread search facebook/react "hooks"
bunx @briansunter/z-cli zread structure vercel/next.js
bunx @briansunter/z-cli zread read vercel/next.js package.json

MCP Server

Run the full MCP server or scope it to a single capability; this keeps Claude Code’s tool surface small.

bunx @briansunter/z-cli mcp           # All 8 tools
bunx @briansunter/z-cli mcp image     # generate_image only
bunx @briansunter/z-cli mcp web       # web_search + web_reader
bunx @briansunter/z-cli mcp zread     # search_doc, get_repo_structure, read_file

Add to your .mcp.json for Claude Code:

{
  "mcpServers": {
    "z-ai": {
      "command": "bunx",
      "args": ["@briansunter/z-cli", "mcp"],
      "env": { "Z_AI_API_KEY": "${Z_AI_API_KEY}" }
    }
  }
}

Technology Stack

• TypeScript on Bun
• Z.AI REST APIs (image, OCR, vision, search, reader, Zread)
• Model Context Protocol (stdio transport)
• npm / bunx distribution