Skip to main content
Glama

⚠️ UNOFFICIAL TOOL: This is an independent, community-developed MCP server. It is not affiliated with, endorsed by, or supported by Google or OpenAI. Use at your own risk.

MCP (Model Context Protocol) server for AI image generation supporting multiple providers:

  • Antigravity (default) - Google's Gemini 3 Pro Image model

  • OpenAI - DALL-E 3

Features

  • Multi-Provider Support: Switch between Antigravity and OpenAI with a simple parameter

  • Text-to-Image: Generate images from text descriptions

  • Image Editing: Modify existing images with text instructions (Antigravity only)

  • Multiple Outputs: Generate up to 4 image variations per request (Antigravity only)

  • Character Consistency: Session-based generation for consistent characters (Antigravity only)

  • Multiple Aspect Ratios: 1:1, 16:9, 9:16, 3:4, 4:3, and more

Related MCP server: Imagen MCP Server

Installation

Run directly with npx (recommended):

npx artifex-mcp

Or install globally:

npm install -g artifex-mcp

Authentication

Antigravity (Default)

npx artifex-mcp --login

This will:

  1. Open your browser for Google OAuth

  2. Store credentials securely in ~/.config/artifex-mcp/auth.json

OpenAI

Set the OPENAI_API_KEY environment variable:

export OPENAI_API_KEY=sk-...

Usage

As an MCP Server

Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "artifex": {
      "command": "npx",
      "args": ["artifex-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

OpenCode:

{
    "mcp": {
        "artifex": {
            "type": "local",
            "command": ["npx", "artifex-mcp"],
            "enabled": true,
            "env": {
                "OPENAI_API_KEY": "sk-..."
            }
        }
    }
}

Environment Variables

Variable

Description

Default

DEFAULT_IMAGE_PROVIDER

Default provider to use

antigravity

DEFAULT_IMAGE_MODEL

Default model for the provider

gemini-3-pro-image

OPENAI_API_KEY

API key for OpenAI provider

-

Provider Selection

Use the model parameter with provider:model format:

# Use Antigravity (default)
generate_image({ prompt: "a cat" })

# Use OpenAI DALL-E 3
generate_image({ prompt: "a cat", model: "openai:dall-e-3" })

# Use a specific Antigravity model
generate_image({ prompt: "a cat", model: "antigravity:gemini-3-pro-image" })

Available Tools

generate_image

Generate images from text prompts.

Parameter

Type

Required

Default

Description

prompt

string

Yes

-

Image description or editing instruction

model

string

No

env default

Provider and model in provider:model format

aspect_ratio

enum

No

"1:1"

1:1, 16:9, 9:16, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 21:9

output_path

string

No

cwd

Directory to save images

file_name

string

No

auto

Custom filename

input_image

string

No

-

Path to image for editing (Antigravity only)

count

number

No

1

Number of images 1-4 (Antigravity only)

session_id

string

No

-

For character consistency (Antigravity only)

Examples:

# Default provider (Antigravity)
Generate a cyberpunk cityscape at night

# Using OpenAI
Generate a cyberpunk cityscape at night, model: openai:dall-e-3

# Multiple images (Antigravity only)
Generate 4 variations of a majestic dragon, aspect ratio 16:9

# Character consistency (Antigravity only)
Create a hero named Luna, session_id: luna

auth_status

Check authentication status for a provider.

Parameter

Type

Required

Description

provider

string

No

Provider to check (default: antigravity)

auth_login

Get instructions for authenticating with a provider.

auth_logout

Delete stored credentials for a provider.

quota_status

Check rate limit and quota status for a provider.

Provider Capabilities

Feature

Antigravity

OpenAI

Text-to-Image

✅

✅

Image Editing

✅

❌

Multiple Images

✅ (1-4)

❌ (1 only)

Sessions

✅

❌

Aspect Ratios

✅

✅ (limited)

Auth Type

Google OAuth

API Key

File Locations

Purpose

Location

Credentials

~/.config/artifex-mcp/auth.json

Sessions

~/.cache/artifex-mcp/sessions/

Generated Images

Current working directory (or custom path)

Troubleshooting

"Not authenticated" error (Antigravity)

npx artifex-mcp --login

"OpenAI API key not found" error

Set the environment variable:

export OPENAI_API_KEY=sk-...

Rate limit exceeded

Wait for the time indicated in the error message. Rate limits are enforced per-account.

Unsupported feature error

Some features are only available on specific providers. For example:

  • session_id only works with Antigravity

  • input_image (editing) only works with Antigravity

  • count > 1 only works with Antigravity

License

MIT

Intended Use

  • Personal / internal development only

  • Respect quotas and data handling policies

  • Not for production services or bypassing intended limits

Warning

By using this plugin, you acknowledge:

  • Terms of Service risk — This approach may violate ToS of AI model providers

  • Account risk — Providers may suspend or ban accounts

  • No guarantees — APIs may change without notice

  • Assumption of risk — You assume all legal, financial, and technical risks

Disclaimer

Not affiliated with Google or OpenAI. This is an independent open-source project.

"Antigravity", "Gemini", "Google Cloud", "Google", "OpenAI", and "DALL-E" are trademarks of their respective owners.

Available Tools

5 tools
auth_loginB

Get instructions for authenticating with an image generation provider

Inputs: provider.

auth_logoutA

Log out and delete stored credentials for an image generation provider

Inputs: provider.

auth_statusA

Check authentication status for an image generation provider

Inputs: provider.

generate_imageA

Generate images using AI. Supports multiple providers (Antigravity/Gemini, OpenAI DALL-E, etc.). Use 'model' parameter to specify provider:model format.

Inputs: prompt (required), count, model, file_name, +4 more.

quota_statusA

Check rate limit and quota status for an image generation provider

Inputs: provider.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: generate_image creates images, while auth_status, auth_login, auth_logout handle different aspects of authentication (status, instructions, and logout), and quota_status checks rate limits. There is minimal potential for confusion due to clear descriptions.

    Naming Consistency4/5

    Tool names generally follow a pattern: action tools like generate_image and auth_login/logout use verb_noun, while status tools use domain_status (auth_status, quota_status). The only minor inconsistency is that generate_image lacks a domain prefix unlike the auth/quota tools, but the convention is still readable and predictable.

    Tool Count5/5

    With 5 tools, the server is well-scoped for image generation. It provides essential functionality: generation, authentication management, and quota checking, without unnecessary bloat.

    Completeness4/5

    The core image generation workflow is covered, alongside authentication and quota monitoring. A notable gap is the lack of a tool to list available models/providers, which would help users understand the 'model' parameter for generate_image, but it is a minor omission.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers