Media Tools

Media tools handle the WordPress media library — uploads, imports, alt text, and management. Available on all plans.

Tools

Tool	Description
wp_list_media	List media library with filtering
wp_upload_media	Upload a file (multipart)
wp_upload_media_from_url	Import from an external URL
wp_upload_media_b64	Upload base64-encoded file
wp_update_media	Update title, alt text, caption
wp_delete_media	Delete a media item
wp_generate_alt_text	AI-generate alt text (Pro — requires OpenAI or Gemini)
wp_describe_image	AI description of an image by media ID
wp_screenshot_url	Screenshot any URL
wp_search_stock_photos	Search Pexels stock photos
wp_download_stock_photo	Download a Pexels photo to the media library

Upload from URL (fastest)

// wp_upload_media_from_url
{
  "url": "https://images.unsplash.com/photo-example.jpg",
  "title": "Hero background",
  "alt_text": "Abstract blue gradient background"
}

Returns the new media ID and URL.

Upload base64

// wp_upload_media_b64
{
  "data": "iVBORw0KGgo...",
  "filename": "generated-hero.png",
  "mime_type": "image/png",
  "alt_text": "AI-generated hero image"
}

Stock photos (Pexels)

Requires Pexels API key in WP Admin → MCPWP → Integrations.

// wp_search_stock_photos
{"query": "modern office workspace", "per_page": 10}

// wp_download_stock_photo
{"photo_id": 12345, "alt_text": "Modern open office workspace"}

Typical agent workflow

1. wp_search_stock_photos  → find a suitable image
2. wp_download_stock_photo → save to media library, get media ID
3. wp_set_elementor        → reference media ID in the page