{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qpwe4px4f9xc","handle":"image-gen-mcp","url":"https://wellknown.network/agents/image-gen-mcp","links":{"self":"https://wellknown.network/agents/image-gen-mcp/record.json","html":"https://wellknown.network/agents/image-gen-mcp","markdown":"https://wellknown.network/agents/image-gen-mcp/record.md","api":"https://wellknown.network/api/v1/agents/image-gen-mcp","status":"https://wellknown.network/api/v1/agents/image-gen-mcp/status","claim":"https://wellknown.network/agents/image-gen-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/image-gen-mcp/claim.json","badge":"https://wellknown.network/agents/image-gen-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/image-gen-mcp/history","tools":"https://wellknown.network/api/v1/agents/image-gen-mcp/tools"},"ard":{"identifier":"urn:air::server:image-gen-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"image-gen-mcp","summary":"MCP image generation server with modular engines and routing","description":"# 🎨 Image Gen MCP Server\n\n> *\"Fine. I'll do it myself.\"* — Thanos (and also me, after trying five different MCP servers that couldn't mix-and-match image models)  \n> I wanted a single, **simple** MCP server that lets agents generate **and** edit images across OpenAI, Google (Gemini/Imagen), Azure, Vertex, and OpenRouter—without yak‑shaving. So… here it is.\n\n[![PyPI version](https://img.shields.io/pypi/v/image-gen-mcp.svg)](https://pypi.org/project/image-gen-mcp/) ![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue) ![license](https://img.shields.io/badge/license-Apache%202.0-blue)\n\nA multi‑provider **Model Context Protocol** (MCP) server for image **generation** and **editing** with a unified, type‑safe API. It returns MCP `ImageContent` blocks plus compact structured JSON so your client can route, log, or inspect results cleanly.\n\n> [!IMPORTANT]\n> This `README.md` is the canonical reference for API, capabilities, and usage. Some `/docs` files may lag behind.\n\n---\n\n## 🗺️ Table of Contents\n\n- [Why this exists](#-why-this-exists)\n- [Features](#-features)\n- [Quick start (users)](#-quick-start-users)\n- [Quick start (developers)](#-quick-start-developers)\n- [Configure `mcp.json`](#-configure-mcpjson)\n- [Tools API](#-tools-api)\n  - [`generate_image`](#-generate_image)\n  - [`edit_image`](#-edit_image)\n  - [`get_model_capabilities`](#-get_model_capabilities)\n- [Providers & Models](#-providers--models)\n- [Python client example](#-python-client-example)\n- [Environment Variables](#-environment-variables)\n- [Running via FastMCP CLI](#-running-via-fastmcp-cli)\n- [Troubleshooting & FAQ](#-troubleshooting--faq)\n- [Contributing & Releases](#-contributing--releases)\n- [License](#-license)\n\n---\n\n## 🧠 Why this exists\n\nBecause I couldn’t find an MCP server that spoke **multiple image providers** with **one sane schema**. Some only generated, some only edited, some required summoning three different CLIs at midnight.  \nThis one prioritizes:\n\n- **One schema** across prov…","publisher":null,"homepage":"https://github.com/simonChoi034/image-gen-mcp","repository":"https://github.com/simonChoi034/image-gen-mcp/releases","version":"1.4.0","license":"MIT","protocols":["mcp"],"tags":["ai","dall-e","gemini","image-generation","imagen","mcp","model-context-protocol","openai","vertex-ai"],"pricing":null,"endpoints":[{"url":"pypi:image-gen-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-generation","name":"Image Generation","confidence":1,"provenance":"declared"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["dev","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"image-gen-mcp","registry":"pypi","observedAt":"2026-09-15T21:21:58.220Z","publishedAt":"2025-09-11T04:36:58.974401Z","latestVersion":"1.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"image-gen-mcp","url":"https://pypi.org/project/image-gen-mcp/","firstSeenAt":"2026-09-09T21:25:33.458Z","fetchedAt":"2026-09-15T21:19:47.310Z","normalizedAt":"2026-09-15T21:19:47.310Z"}]},"firstSeenAt":"2026-09-09T21:25:33.458Z","updatedAt":"2026-09-15T21:21:58.220Z"}