WordPress MCP Server

Instructions

Args:
    per_page: Number of items to return (1-100). Default is 10.
    media_type: Filter by type - 'image', 'video', 'audio', or 'application'.

Returns:
    List of media items with id, title, url, mime_type, and alt_text.

Implementation Reference

• src/wordpress_mcp/server.py:62-77 (handler)

  MCP tool handler function for 'wp_get_media'. Decorated with @mcp.tool() for registration. Calls WordPressClient.get_media() to fetch and return media items.

  @mcp.tool()
  def wp_get_media(
      per_page: int = 10,
      media_type: str | None = None,
  ) -> list[dict]:
      """Get media items from WordPress media library.
  
      Args:
          per_page: Number of items to return (1-100). Default is 10.
          media_type: Filter by type - 'image', 'video', 'audio', or 'application'.
  
      Returns:
          List of media items with id, title, url, mime_type, and alt_text.
      """
      client = get_client()
      return client.get_media(per_page=per_page, media_type=media_type)

• src/wordpress_mcp/client.py:122-144 (helper)

  Supporting method in WordPressClient that makes the REST API GET request to the /media endpoint, processes the response, and returns formatted list of media items.

  def get_media(
      self,
      per_page: int = 10,
      media_type: str | None = None,
  ) -> list[dict]:
      """Get media items from WordPress."""
      params = {"per_page": per_page}
  
      if media_type:
          params["media_type"] = media_type
  
      media = self._get("media", params)
  
      return [
          {
              "id": m["id"],
              "title": m["title"]["rendered"],
              "url": m["source_url"],
              "mime_type": m["mime_type"],
              "alt_text": m.get("alt_text", ""),
          }
          for m in media
      ]