Skip to main content

WordPress Media

Provider id: wp-media ยท 4 tool(s).

create_mediaโ€‹

Upload a file to the media library by downloading it from a source URL.

Profiles: full, wp

Parameters

ParameterTypeRequiredDescription
source_urlstringyesPublic URL of the file to download and upload.
filenamestringnoOptional filename to store as.
titlestringnoOptional attachment title.
alt_textstringnoOptional image alt text.
post_idintegernoOptional post ID to attach the media to.

delete_mediaโ€‹

Delete a media item. Media deletion always bypasses the trash.

๐Ÿ”ด Destructive โ€” supports a dry_run preview flag.
Profiles: full, wp

Parameters

ParameterTypeRequiredDescription
idintegeryesAttachment ID.

edit_mediaโ€‹

Update media metadata (title, caption, description, alt text).

Profiles: full, wp

Parameters

ParameterTypeRequiredDescription
idintegeryesAttachment ID.
titlestringno
captionstringno
descriptionstringno
alt_textstringno

list_mediaโ€‹

List media library items with optional search and pagination.

Profiles: full, lean, wp

Parameters

ParameterTypeRequiredDescription
searchstringnoSearch term.
media_typestringnoFilter by type (image, video, audio, application).
per_pageintegernoItems per page (1-100).
pageintegernoPage number.
parentintegernoFilter by attached post ID.