openai-creative-plugin

OpenAI Creative Plugin

A Model Context Protocol (MCP) server for AI image generation and editing using OpenAI GPT Image models. Designed for LLM/AI agents using Claude Code.

Version: v0.1.2 | Default Model: gpt-image-2

---

Features

• Text-to-Image Generation — Create images from detailed text prompts
• Image Editing — Modify existing images with text instructions and reference images
• Iterative Refinement — Continue editing the last image without path tracking
• Multi-Image Composition — Up to 16 reference images for style transfer and consistency
• Transparent Backgrounds — Native alpha-channel output via gpt-image-1.5 (no post-cut needed — the key gamedev win)
• Session Management — Organized multi-turn workflows with defaults, file organization, and stats
• Multi-Model Support — Two GPT Image models with capability-based feature gating
• Prompt Templates — Built-in templates for sprites, UI, characters, and more
• Claude Code Skills — 9 slash commands encoding workflow knowledge for AI agents

---

Models

Model ID	Max Refs	Sizes	Transparent BG	inputFidelity
gpt-image-2 ⭐ DEFAULT	16	presets + arbitrary WxH (÷16, ≤3:1, ≤3840px)	❌	❌ always high
gpt-image-1.5	16	auto, 1024x1024, 1536x1024, 1024x1536	✅	✅ high/low

Key distinction: gpt-image-2 produces the highest quality but cannot output transparent PNGs. For game sprites requiring alpha channel, use gpt-image-1.5.

---

Installation

As a Claude Code plugin (recommended)

Two slash commands inside Claude Code:

/plugin marketplace add https://github.com/2901were/openai-creative-plugin
/plugin install openai-creative-plugin@openai-creative-marketplace

The first registers this repo as a Claude Code plugin marketplace (reading the marketplace.json at the repo root). The second installs the plugin from that marketplace — auto-registering the MCP server and the 9 auto-activating skills.

Then set your OPENAI_API_KEY:

export OPENAI_API_KEY="your-key-from-https://platform.openai.com/api-keys"

That's it.

Organization Verification note: GPT Image models require Organization Verification on your OpenAI account before the API will accept image requests. Visit platform.openai.com → Settings → Organization → Verification if you get a 403 error.

From source (development only)

git clone https://github.com/2901were/openai-creative-plugin
cd openai-creative-plugin
npm install
npm run build

The compiled output at dist/index.js is what the plugin uses.

---

Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• An OpenAI API key from platform.openai.com/api-keys
• Organization Verification on your OpenAI account (required for GPT Image models)

Configuration

Three methods, checked in priority order:

1. Environment variable (recommended)

export OPENAI_API_KEY="your-api-key-here"

2. MCP client config

{
  "mcpServers": {
    "openai-creative": {
      "command": "node",
      "args": ["/path/to/openai-creative-plugin/dist/index.js"],
      "env": { "OPENAI_API_KEY": "your-api-key-here" }
    }
  }
}

3. Runtime tool

configure_openai_token({ apiKey: "your-api-key-here" })

Example: Transparent sprite (the differentiator)

// Start a session configured for transparent sprite output
start_creative_session({
  model: "gpt-image-1.5",
  background: "transparent",
  aspectRatio: "1:1",
  description: "Knight sprites for platformer game"
})

// Generate base sprite — returned PNG has alpha channel, no post-cut needed
send_creative_message({
  prompt: "2D pixel art knight character, idle pose, blue tabard with gold lion crest, 1px black outline, PICO-8 palette, isolated subject"
})

// Generate walking pose maintaining visual consistency
send_creative_message({
  prompt: "Same knight in walking pose",
  images: ["/path/to/idle.png"]   // routes to /images/edits for visual grounding
})

---

Tools (11 total)

Basic Tools

get_configuration_status

Check if the API is configured and ready. No parameters.

configure_openai_token

Set your OpenAI API key at runtime. Saves to .openai-creative-config.json.

• apiKey (required): Your key from platform.openai.com/api-keys