# Imag8 Studio MCP Server

Style-locking AI image generation for your AI agents. Define one master style, generate unlimited matching images, and let Claude, Cursor, ChatGPT or your own agents do the rest.

## What is Imag8?

Imag8 is a style-locking image generation engine. You define a master style once (lighting, mood, composition, colour), then generate unlimited images with different subjects but the same visual identity. No more collections that look like ten different artists made them.

This repo documents the hosted MCP server and REST API so any AI agent can generate on-brand images.

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "imag8": {
      "type": "http",
      "url": "https://imag8.art/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer imag8_sk_YOUR_KEY"
      }
    }
  }
}
```

### Cursor

Settings → MCP → Add new MCP server:

- **Type:** HTTP/SSE
- **URL:** `https://imag8.art/api/v1/mcp`
- **Headers:** `Authorization: Bearer imag8_sk_YOUR_KEY`

### ChatGPT / Custom Agents

Point any MCP client at `https://imag8.art/api/v1/mcp` (JSON-RPC 2.0) with the same bearer header. OpenAPI spec in [`openapi.json`](openapi.json).

## Get an API key

Sign up at [imag8.art](https://imag8.art), open the Account deck, and generate a key. Creator and Pro plans include API and MCP access. Free tier: 10 credits/month.

## Tools

| Tool | Description |
|------|-------------|
| `imag8_generate_image` | Generate an image in a locked style. Params: subject, stylePrompt, aspectRatio (1:1, 4:3, 16:9, 9:16), resolution (512, 1024, 2048, 4096), useHighQuality |
| `imag8_suggest_variations` | Suggest subject variations that fit the current master style |
| `imag8_get_account_status` | Check credits and account status |

## REST API

```
POST /api/v1/generate
Authorization: Bearer imag8_sk_...
```

```json
{
  "subject": "ceramic teapot",
  "stylePrompt": "pure white catalog, seamless studio lighting",
  "aspectRatio": "1:1",
  "resolution": "1024px"
}
```

Also available: `POST /api/v1/suggest-variations`, `GET /api/v1/account`.

## Why style locking?

Single-image generation is easy with any AI tool. Making a collection that matches stylistically is the hard part. Imag8 locks lighting, lens, texture and mood while varying only the subject, so every image looks art-directed by the same person.

Use cases: e-commerce product photography, print-on-demand merch lines, brand assets, web hero imagery, social media content.

## Links

- Website: [imag8.art](https://imag8.art)
- Pricing: [imag8.art/#pricing](https://imag8.art/#pricing)
- API spec: [openapi.json](openapi.json)

Licensed for use with Imag8 Studio accounts. See [imag8.art](https://imag8.art) for terms.