fvtt-mcp-imagegen

An MCP server that lets Claude make art for your Foundry VTT table using Google’s Gemini image models (Nano Banana). Four tools, one API key, no GPU.

Claude Code drives it. The server is registered as imagegen, and its illustration-builder skill grounds every piece in what your world already says and shows. Claude writes the prompt, the server renders it, Claude looks at the result and fixes what is wrong, and the finished file lands on disk ready to upload into Foundry.

What you can make

• Item, spell, and feature icons. Twenty icons from one style line come back as one matching set. About 3 cents each.
• Tokens. Top-down, full-body, cut to transparency, centred on a square so Foundry’s scale 1.0 is right: 512 px, or 1024 px for Large and bigger creatures. Humanoids face up at the camera; beasts are seen along the back. No shadow, and nothing ever clips off the edge: a render with a sword or wing cut by the frame is redone, and refused if it clips twice. Hand it one of your existing tokens as a style reference and new ones match the angle and look. About 3 cents each.
• Token refreshes. Point it at an old, low-res token and it repaints it at higher quality while keeping the pose, silhouette, design, and colours your players know. It can also turn one creature into another in the same pose (a rat’s token into a squirrel).
• Token redresses. Start from a token you already have as the prototype and change who it is: “make this a Sharran cleric, black armour, a morningstar instead of the club”. The pose, camera angle, and cut stay; the costume, gear, and figure change to match the actor it is now for. One stock token becomes the specific NPC in your world without a word of prompt about framing.
• Token restyles. The same trick as battlemaps, for a whole bestiary. Tokens gathered from different packs (Immortal Nights, Forgotten Adventures, a few you drew yourself) do not match on one map. Hand it one token as the style reference and run the rest through, and they come back in one consistent look, each still recognisably the creature it was.
• Props. Map dressing placed as tiles: furniture, barrels, trees, anvils. Seen straight down, object only, cut to transparency at the tile size (300 px per grid cell, from a footprint like "2x1"). Refreshing an existing prop returns it at the file’s exact pixel size in the same spot on its canvas, so it replaces the old one one for one.
• Battlemap restyles. Repaint a map you bought (Tom Cartos, Mad Cartographer, anything) in one consistent painted style, with every wall, door, and object exactly where it was, so the walls and lights already traced over it in Foundry still fit. The result lands on the source’s own pixel grid. An old low-res map comes back at a whole-number upscale (a