Artifex MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Artifex MCP Generate a surreal landscape with floating islands and waterfalls"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚠️ 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-mcpOr install globally:
npm install -g artifex-mcpAuthentication
Antigravity (Default)
npx artifex-mcp --loginThis will:
Open your browser for Google OAuth
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 provider to use |
|
| Default model for the provider |
|
| 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 |
| string | Yes | - | Image description or editing instruction |
| string | No | env default | Provider and model in |
| enum | No | "1:1" | 1:1, 16:9, 9:16, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 21:9 |
| string | No | cwd | Directory to save images |
| string | No | auto | Custom filename |
| string | No | - | Path to image for editing (Antigravity only) |
| number | No | 1 | Number of images 1-4 (Antigravity only) |
| 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: lunaauth_status
Check authentication status for a provider.
Parameter | Type | Required | Description |
| 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 |
|
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_idonly works with Antigravityinput_image(editing) only works with Antigravitycount > 1only 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 toolsauth_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
Scored across 5 tools
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.
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.
With 5 tools, the server is well-scoped for image generation. It provides essential functionality: generation, authentication management, and quota checking, without unnecessary bloat.
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
Related MCP Connectors
Generate, edit and upscale images with references, batch jobs, cost previews and original downloads.
Generate and upscale AI images, video and audio with leading models, right from your AI chat.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate AI images, videos, music, SFX & speech in any AI assistant. Results appear inline in chat.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables text-to-image generation, image editing, and multi-image composition using Google's Gemini 2.5 Flash Image API. Supports flexible aspect ratios and character consistency across generations.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to generate high-quality images using Google's Gemini and Imagen models with support for multiple aspect ratios, dynamic model selection, and direct file saving capabilities.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI image generation through multiple providers including OpenAI GPT-Image-1, Google Imagen 4, Gemini 2.5 Flash (Nano Banana), Flux 1.1, Qwen Image, and SeedDream-4, supporting various formats, sizes, and advanced features like background control and seed-based reproduction.59 npm11MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI-assisted image generation from text prompts using multiple providers (Tencent Hunyuan, OpenAI DALL-E 3, and Doubao) with support for various artistic styles, resolutions, and negative prompts through a unified interface.1MIT