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

InputTypeRequiredNotes
imagesobject[]yesEach exactly one image source. up to 20 items
collectionIdstringnoAn existing collection (from list_collections) to add them to. up to 200 characters
newCollectionobjectnoMake 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

FieldTypeNotes
savedobject[]The images saved to the Media library.
collectionobject | nullThe collection they were also added to; null when none.
mediaLibrarystringLink to the Media library in Wavegrain.
notestringWhat 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.

Something wrong or missing? Write to support@wavegrain.com.