Skip to main content

figurify-mcp

PyPI Python CI License

An MCP server that adds image generation to Claude, Cursor, VSCode Copilot, and any other MCP-compatible host that does not have native image generation.

Currently supports Google Gemini + Imagen. Support for other image-generation providers is on the roadmap.

Install

pip install figurify-mcp

You will need a Gemini API key — create one at aistudio.google.com/apikey.

Setup in your host

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "figurify": {
      "command": "uvx",
      "args": ["figurify-mcp"],
      "env": { "GOOGLE_API_KEY": "your-key" }
    }
  }
}

Claude Code / Cursor

claude mcp add figurify -s user \
  -e GOOGLE_API_KEY=$GOOGLE_API_KEY \
  -- uvx figurify-mcp

VSCode Copilot

Create .vscode/mcp.json:

{
  "servers": {
    "figurify": {
      "command": "uvx",
      "args": ["figurify-mcp"],
      "env": { "GOOGLE_API_KEY": "your-key" }
    }
  }
}

Restart the host. Ten tools become available automatically.

Tools

Tool What it does
create_simple_diagram Prompt → image. One call.
create_infographic Topic → styled poster (VLM designs layout, Imagen renders).
create_methodology_diagram Academic paper figure with iterative critique.
create_statistical_plot Tabular data → matplotlib chart.
evaluate_diagram VLM-as-judge comparison of two diagrams.

Five additional meta-tools help the host pick the right tool without loading every schema upfront: search_tools, describe_tool, recommend_model, estimate_cost, list_available_models.

All generation tools default to 1K resolution so images render inline without hitting the ~1 MB tool-result cap enforced by Claude.

Configuration

All environment variables are optional except GOOGLE_API_KEY.

Variable Default Description
GOOGLE_API_KEY required Gemini + Imagen API key
FIGURIFY_OUTPUT_DIR ~/.figurify/outputs Where generated PNGs are saved
FIGURIFY_VLM_MODEL auto-routed Pin a specific Gemini text/vision model
FIGURIFY_IMAGE_MODEL auto-routed Pin a specific image-generation model
FIGURIFY_MAX_METHODOLOGY_ITERATIONS 4 Upper bound for the critique loop

Transports

figurify-mcp                                             # stdio (default)
figurify-mcp --transport http --host 0.0.0.0 --port 8765 # streamable HTTP

Stdio is what hosts like Claude Desktop use. HTTP is useful for remote deployments (ChatGPT Apps SDK, VSCode Copilot remote MCP).

Development

git clone https://github.com/genaimanoj/figurify-mcp
cd figurify-mcp
uv venv && source .venv/bin/activate
uv pip install -e '.[dev]'
cp .env.example .env   # set GOOGLE_API_KEY
pytest -q

Issues, feature requests, and pull requests welcome at github.com/genaimanoj/figurify-mcp.

License

MIT · © 2026 Manoj Bhandari

Metadata

Release files for figurify-mcp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for figurify-mcp 0.2.2
File Size Uploaded
figurify_mcp-0.2.2.tar.gz 33.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for figurify-mcp 0.2.2
File Interpreter ABI Platform
figurify_mcp-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 68.0 kB

Release files / figurify_mcp-0.2.2.tar.gz

Download URL figurify_mcp-0.2.2.tar.gz
Size 33.7 kB
Tags Source
SHA-256 checksum
How to use checksums
88441829699d55a5e52861f41de4f08e19c30e51a205f1bfd0ffa012d587f647
BLAKE2b-256 checksum
How to use checksums
1c2a8ec195b15b5e9c771d0c999032bbcf29957feef8b8e764b9b1a98f5f4e0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 17, 2026.

Transparency log

Release files / figurify_mcp-0.2.2-py3-none-any.whl

Download URL figurify_mcp-0.2.2-py3-none-any.whl
Size 34.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9a6fb55b89d7470fe66d5c8290b0cec7d8046104c96bf95519e12c1ad0478534
BLAKE2b-256 checksum
How to use checksums
5ac18766e141212ff94c113742cd42662c2df39919318df4c3403dd6054af47b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 17, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page