Image and Gallery Tools (Apprentice MCP)
These built-in tools let an agent generate images and manage gallery files. Both families are off by default, so you enable them only for agents that need them.
Image generation is gated by the Image Generation MCP capability. Gallery file tools are gated by the Gallery MCP capability.
What These Tools Are For
- Image generation: create images from a prompt.
- Gallery: list, read, write, rename, and delete gallery files.
Both are disabled by default because they are specialized and, for image generation, can incur cost.
Image Generation Tools
generate_image: generate an image from a prompt.
Image generation requires the Image Generation MCP capability. It is budget-gated, so an agent without budget headroom cannot generate images. Configure image provider settings before relying on this tool. See Configure Agent Budgets and Cost Controls.
Gallery Tools
list_gallery_sources: list available gallery sources.list_gallery_images: list images in a gallery.read_gallery_image: read an image from the gallery.write_gallery_file: write a file to the gallery.delete_gallery_file: delete a gallery file.rename_gallery_file: rename a gallery file.
Gallery tools require the Gallery MCP capability.
Designing Around Images
Good patterns:
- Enable Image Generation MCP only for agents whose job is visual output, and set a budget.
- Enable Gallery MCP when an agent should manage generated or uploaded image files.
- Review the first runs in Activity to confirm cost and output match expectations.
Next Step
Return to Built-in Agent Tools for the full tool family map, or open Configure Agent Capabilities to enable these families.