Export & Screenshot Tools
Tools for rendering the canvas and exporting to images.
get_screenshot
Get a screenshot of the current canvas as a base64 PNG image. This is useful for the AI to see what it has designed and make adjustments.
Parameters: None
Returns: Base64 PNG image (rendered at 1x scale)
The response contains an image content type that AI agents can view directly:
{
"content": [{
"type": "image",
"data": "iVBORw0KGgo...",
"mimeType": "image/png"
}]
}
Example prompt: "Show me what the canvas looks like right now"
Tip: Call
get_screenshotafter adding elements so the AI can verify the design looks correct before exporting.
export_canvas
Export the canvas to PNG and upload to Google Cloud Storage. Returns a signed URL valid for 7 days.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
format |
string | No | Export format: png (default) |
scale |
number | No | Scale factor (default: 2.0 for high DPI) |
Returns: JSON with signed URL and file info
{
"success": true,
"signedUrl": "https://storage.googleapis.com/...",
"gcsPath": "gigma-exports/userId/projectId/timestamp.png",
"fileSize": 123456
}
Scale Factor
| Scale | Output Size (1920x1080 canvas) | Use Case |
|---|---|---|
| 1 | 1920x1080 | Web preview |
| 2 | 3840x2160 | Standard export (default) |
| 3 | 5760x3240 | High-quality print |
Example prompt: "Export the design as a high-res PNG"
capture_webpage
Note: This tool is not supported in the web version. Use
add_elementwithtype: "image"and animageUrlparameter instead.
In the desktop version, this tool captures a webpage screenshot and adds it to the canvas. In the web version, it returns a helpful message suggesting the alternative approach.
Server-Side Rendering
The MCP server uses @napi-rs/canvas (Node.js Canvas 2D API) for server-side rendering. This means:
- Text rendering uses Noto Sans fonts with CJK (Chinese/Japanese/Korean) support
- Images are downloaded from URLs and drawn onto the canvas
- All element properties are respected: rotation, opacity, masks, corner radius
- Export quality is controlled by the
scalefactor
Rendering Order
- Canvas background (
backgroundColor) - Elements drawn bottom-to-top (array order)
- For each element: opacity, rotation, mask clip, shape/text/image, mask border
Supported Features
| Feature | Supported |
|---|---|
| Rectangles with rounded corners | Yes |
| Circles / ellipses | Yes |
| Text with font weight & alignment | Yes |
| Images from URL | Yes |
| Lines | Yes |
| Rotation | Yes |
| Opacity | Yes |
| Clip masks (circle, ellipse, roundedRect) | Yes |
| Stroke borders | Yes |
| PDF export | No (PNG only in web version) |