Tools Catalog / Media generation / wp_get_media

wp_get_media tool reference for media workflows

Read-only
Group LibraryCapability upload_files

lists media library attachments with limit and offset.

Description

lists media library attachments with limit and offset.

What it is for

  • Finding existing images or files.
  • Preparing asset selection for posts.

Example use case

image library review.

Sample prompt

List the latest 20 media items so I can choose a banner image for the homepage.

Sample response

{
  "tool": "wp_get_media",
  "status": "ok",
  "items": []
}

What does wp_get_media do?

lists media library attachments with limit and offset.

Does wp_get_media modify the media library?

No. It reads media records without changing the library.

Which capability is commonly required?

It usually runs under controls compatible with upload_files and the active MCP profile.

How should wp_get_media be used safely?

Use focused queries and keep the scope limited to the asset set you need.

What dependency should be confirmed first?

WordPress media library