save_images
Save images to the library with Wavegrain's MCP server: the save_images tool needs the write permission. Inputs, outputs and an example call.
Save images to the library. Permission: write. Changes saved work.
Keep up to 20 images in the user's Media library, and optionally a collection. Upload files with create_upload first. Only the user's own uploads, imports, library images or search_images candidates. Free.
Inputs
| Input | Type | Required | Notes |
|---|---|---|---|
images | object[] | yes | Each exactly one image source. up to 20 items |
collectionId | string | no | An existing collection (from list_collections) to add them to. up to 200 characters |
newCollection | object | no | Make a new collection and add them to it, instead of collectionId. |
The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.
Returns
| Field | Type | Notes |
|---|---|---|
saved | object[] | The images saved to the Media library. |
collection | object | null | The collection they were also added to; null when none. |
mediaLibrary | string | Link to the Media library in Wavegrain. |
note | string | What to tell the user. |
Example call
Send it to POST https://wavegrain.com/api/mcp with an access key that has the write permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "save_images",
"arguments": {
"images": [
{
"candidate": "<candidate>"
}
]
}
}
}
The call shows only the required inputs, with placeholder values: put your own in.
Related tools
schedule_slideshows: Schedule slideshowsunschedule_slideshow: Unschedule a slideshowedit_slides: Edit slidesopen_upload: Open a drop zone for photosimport_image: Import an image from a URLexport_slideshow: Export a slideshow- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.