# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/schedule_slideshows): Schedule slideshows
- [`unschedule_slideshow`](/developers/mcp-tools/unschedule_slideshow): Unschedule a slideshow
- [`edit_slides`](/developers/mcp-tools/edit_slides): Edit slides
- [`open_upload`](/developers/mcp-tools/open_upload): Open a drop zone for photos
- [`import_image`](/developers/mcp-tools/import_image): Import an image from a URL
- [`export_slideshow`](/developers/mcp-tools/export_slideshow): Export a slideshow
- [All 79 tools](/developers/mcp-tools)
