# Getty Images MCP > Getty Images MCP gives your agent full control over searching, managing, and acquiring stock media. Instantly search millions of editorial and creative photos, find videos, or download high-res assets directly from any chat window. ## Overview - **Category:** design-creative - **Price:** Free - **Tags:** stock-photography, media-procurement, editorial-images, asset-management, creative-assets ## Description Managing visual content used to mean switching between a dozen tabs: the image library, the video catalog, the rights database, and the asset management system. Now, you can handle all that research through natural conversation. You simply tell your agent what you need—for example, 'Find three images of renewable energy for an ad campaign'—and it pulls results from millions of assets across editorial or commercial libraries. Need to check if a historical event was covered in the news? Just ask the agent to audit archival photography. Want to download a specific photo for your presentation? It handles that too. When you connect this MCP via Vinkius, all those search and procurement tools become available right inside your workflow, letting you discover visually similar assets or list out all your saved lightboxes without ever leaving your chat client. ## Tools ### search_images Searches general Getty stock photos and returns basic details like IDs, titles, captions, and preview URLs. ### search_creative Limits searches exclusively to commercial-use creative images, guaranteeing suitability for advertising and marketing. ### search_editorial Searches archival and news photography that is intended for journalistic or editorial use, not commercial promotion. ### get_image Retrieves comprehensive metadata and full details about a single specific Getty image asset ID. ### get_images_batch Pulls detailed information for multiple Getty images at the same time, saving you from calling the tool repeatedly. ### search_videos Searches and retrieves metadata for stock video libraries, including duration and aspect ratio. ### get_video Gets detailed information about a single specific Getty video asset ID. ### download_image Downloads a high-resolution version of an image by its ID, consuming the necessary corporate usage quota. ### get_similar Finds and lists alternative images that share similar visual compositions or aesthetic patterns with a given asset ID. ### list_collections Lists all your saved Lightbox collections, allowing you to see and manage assets organized across different projects. ## Prompt Examples **Prompt:** ``` Search for creative images of 'modern sustainable architecture' ``` **Response:** ``` Searching creative library... I found several high-quality images of sustainable buildings with solar panels and vertical gardens. Would you like to see the preview URLs and asset IDs for these? ``` **Prompt:** ``` Find visually similar images to asset '12345678' ``` **Response:** ``` Analyzing visual properties... I found 5 similar assets with matching aesthetic patterns and compositions. I can provide the titles and artist names for these related images. ``` **Prompt:** ``` List my Getty lightboxes ``` **Response:** ``` Retrieving collections... You have 3 active lightboxes: 'Q2 Web Campaign', 'Social Media Assets', and 'Inspiration Board'. Which one would you like to explore for selected assets? ``` ## Capabilities ### Search for specific photo types You can target different content areas—from general searches to commercial-use creative images, and news-focused editorial archives. ### Discover related visuals By providing an asset ID, the MCP finds other photos that match the composition or aesthetic style of your source image. ### Manage video assets Search through stock video libraries and retrieve key metadata like duration and resolution details. ### Organize collections List, view, and manage all your saved lightboxes to keep project assets grouped logically. ### Download media files Retrieve high-resolution download URLs for images, automatically consuming the required corporate quota limits. ## Use Cases ### Need to verify historical context for a news piece? A journalist needs photos of the 2019 climate summit. They ask their agent, and it uses `search_editorial` to pull only archival images from that specific time period, verifying the event's visual record. ### Campaign needs a perfect background image, but they don't know what style they want. A marketer uploads an existing photo and asks their agent to find alternatives. The MCP uses `get_similar` to suggest five related compositions that match the aesthetic patterns of the original source ID. ### The design team has dozens of assets they need details on before committing. Instead of running 50 individual searches, a designer asks their agent to use `get_images_batch` to collect titles and IDs for all selected photos in one query. ### The client needs specific videos for an ad but struggles with video metadata. A videographer instructs the agent to run `search_videos` on 'city streets at sunset.' The MCP returns results, including the duration and available resolution for every clip. ## Benefits - Stop leaving your chat client. You can run complex searches—like finding commercially-safe creative images using `search_creative`—and get results right in the conversation window. - Don't manually check rights. The MCP allows you to differentiate between general stock media, news coverage (`search_editorial`), and ad-ready assets using specific search tools. - Streamline asset gathering by using `get_images_batch`, which lets your agent pull full details for dozens of photos simultaneously instead of running individual lookups. - Keep everything organized with the ability to list and manage your entire library via `list_collections`, ensuring every project has its own dedicated visual hub. - Speed up production by using `download_image` directly from the chat, which retrieves high-resolution URLs and handles quota tracking automatically. ## How It Works The bottom line is that you get all the power of Getty Images integrated into an interactive chat session. 1. Subscribe to this MCP and provide your Getty Images API Key from the developer portal. 2. Connect it to your preferred AI client (Claude, Cursor, etc.) via Vinkius. 3. Ask your agent a question—like 'Find me three photos of urban cycling'—and use natural language to pull results and perform actions. ## Frequently Asked Questions **How do I use Getty Images MCP to find commercial photos?** Use the `search_creative` tool. This function is specifically designed to search and filter out only commercially safe images, ensuring your content meets advertising standards. **Can Getty Images MCP help me with historical photo research?** Yes, you use `search_editorial`. This searches the news and archival photography libraries, which is ideal for journalists needing to track specific global events or trends. **How do I download a picture using Getty Images MCP?** You execute the `download_image` tool. Just provide the asset ID you want, and the MCP returns the high-resolution URL while managing your corporate quota usage. **Does Getty Images MCP handle video search?** Absolutely. Use `search_videos` to browse stock footage. The results give you critical metadata like duration and resolution, which is vital for video planning. **What if I find a photo and want related ideas?** Use the `get_similar` tool. By feeding it an asset ID, your agent finds visually matching compositions and aesthetic patterns, giving you creative alternatives instantly.