# import_image

> Import an image from a URL with Wavegrain's MCP server: the import_image tool needs the write permission. Inputs, outputs and an example call.

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

**Import an image from a URL.** Permission: `write`. Changes saved work.

Copy a PNG, JPEG or WebP image (at most 8 MB) from a public https URL into the user's uploads as a libraryUrl. Only images the user has the right to use. Free.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `url` | string | yes | A public https:// URL of a PNG, JPEG or WebP image, at most 8 MB. up to 2048 characters |

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 |
| --- | --- | --- |
| `libraryUrl` | string | The stored copy: pass it as an image reference. |
| `contentType` | string | The image type, such as image/jpeg. |

## 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": "import_image",
    "arguments": {
      "url": "<url>"
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`edit_slides`](/developers/mcp-tools/edit_slides): Edit slides
- [`save_images`](/developers/mcp-tools/save_images): Save images to the library
- [`open_upload`](/developers/mcp-tools/open_upload): Open a drop zone for photos
- [`export_slideshow`](/developers/mcp-tools/export_slideshow): Export a slideshow
- [`create_style`](/developers/mcp-tools/create_style): Create a tailored style
- [`edit_style`](/developers/mcp-tools/edit_style): Edit a tailored style
- [All 79 tools](/developers/mcp-tools)
