Search for royalty-free stock images across multiple providers.

Args: query: Search query string providers: Providers to search. Valid values are pexels, unsplash, and pixabay. Names are case-insensitive. If a provider is requested but invalid or unavailable, the search returns an error instead of silently substituting. per_page: Number of results per page page: Page number for pagination sort_by: Sort order ('relevant', 'newest') include_attribution: Whether to include attribution links (defaults to value from ENABLE_ATTRIBUTION_LINKS env var)

Returns: Search results with metadata

Get detailed information about a specific image.

Args: image_id: Provider-prefixed image ID (e.g., 'pexels_12345') include_attribution: Whether to include attribution links (defaults to value from ENABLE_ATTRIBUTION_LINKS env var)

Returns: Detailed image information or None if not found

Download an image to local storage or return base64 encoded data.

Args: image_id: Image ID in format provider_id (e.g., pexels_123456) size: Image size variant to download Options: thumbnail, small, medium, large, original output_path: Optional path to save the image locally. NOTE: If a relative path is provided, it will be resolved from the Image Search MCP server's current working directory, which may not be the project directory. To ensure the file is saved in a specific location, use an absolute path (e.g., /home/user/image-search-mcp/downloads/image.jpg).

Returns: Path to downloaded file or base64 data

Example: download_image("pexels_123456", size="medium", output_path="/absolute/path/to/save.jpg")