---

You: "우리 신제품 세럼 광고 이미지 만들어줘, 화장품 무드로"
Agent: [calls generate_image with seedream-5] → https://…/result.png

Setup (2 minutes)

1. Connect your account (opens a browser approval — no password pasting):

npx gwanggo-mcp login
# or, after install:
gwanggo auth login

New accounts get free credits: sign up at gwanggo.jocoding.io. You can also skip login and set GWANGGO_API_KEY (create one at Dashboard → API keys).

2. Add to your agent:

Claude Code

claude mcp add gwanggo -- npx -y gwanggo-mcp

Claude Desktop / Cursor (claude_desktop_config.json / .cursor/mcp.json)

{
  "mcpServers": {
    "gwanggo": {
      "command": "npx",
      "args": ["-y", "gwanggo-mcp"]
    }
  }
}

Codex CLI (~/.codex/config.toml)

[mcp_servers.gwanggo]
command = "npx"
args = ["-y", "gwanggo-mcp"]

To pass the key explicitly instead of login, add "env": { "GWANGGO_API_KEY": "gwk_..." }.

Tools

Tool	What it does
list_models	35+ image/video models with credit costs and per-model options
generate_image	Text→image / image edit. Waits for completion, returns the URL
generate_video	Text→video / image→video (Seedance 2.0, Kling 3.0, Veo 3.1, Sora 2 …)
get_task	Check a previous generation by id
get_credits	Remaining credit balance

Failed generations are auto-refunded server-side.

CLI usage

The same binary doubles as a CLI:

gwanggo auth login
gwanggo models
gwanggo generate image "neon alley cat, cinematic" --model gpt-image-2 --quality high
gwanggo generate video "waves crashing at dawn" --model seedance-2.0 --resolution 720p --duration 5 --generate-audio
gwanggo me          # account and credits
gwanggo task <id>   # check status

The gwanggo commands reuse the account saved by gwanggo auth login; no API-key environment variable is required. GWANGGO_API_KEY remains available for CI and other non-interactive environments.

How it works

Thin client over the public Gwanggo /v1 REST API — the same API that powers the open-source Gwanggo Studio. Your key is stored at ~/.config/gwanggo/config.json (0600) and sent only as a Bearer token.

License

MIT