# Pexels MCP > Pexels MCP gives your AI client direct access to millions of free stock photos and videos. It lets you search for visuals by keywords or color, pull detailed asset information, and browse entire curated collections without leaving your development environment. Stop browsing websites; start retrieving media data instantly. ## Overview - **Category:** design-creative - **Price:** Free - **Tags:** stock-photos, stock-videos, media-library, visual-assets, api-integration ## Description Need high-quality visual assets but don't want to open a new browser tab? This MCP connects your AI agent straight to Pexels’ massive library of free stock photos and videos. You can ask your client to find everything you need, from specific images based on color codes to entire sets of professionally curated content. It handles the heavy lifting: searching for general keywords, pulling metadata for single assets, or listing out all the media in a pre-defined collection. This means instead of manually clicking through image search results and copying links, your agent executes complex visual queries behind the scenes. You can pull down popular videos, check specific photo details, and even see what collections Pexels has highlighted for you. Because this MCP is hosted on Vinkius, it acts as a universal gateway, giving any compatible AI client access to these media tools right alongside whatever else your agent needs to do. It's about getting the content you need, structured data, and ready-to-use links—all without leaving your chat window or IDE. ## Tools ### get_collection_media Retrieves all the photos and videos that belong inside a specified Pexels collection. ### get_curated_photos Fetches a list of hand-picked photos selected by Pexels staff for current trends or themes. ### get_featured_collections Lists the official, recommended collections curated and highlighted by Pexels itself. ### get_photo_details Pulls all available metadata for one specific photo asset using its ID. ### get_popular_videos Gets a list of the highest-performing and most popular videos currently on Pexels. ### get_video_details Pulls all available metadata for one specific video asset using its ID. ### list_my_collections Displays a list of personal collections that you have created or saved on Pexels. ### search_photos_by_color Searches the entire photo library and filters results to only show images containing a specific color hex code. ### search_photos Performs general searches for free stock photos across all keywords, supporting pagination for large result sets. ### search_videos Performs general searches for free stock videos based on descriptive keywords. ## Prompt Examples **Prompt:** ``` Check matrices explicitly discovering global array targets isolating high quality photos nicely querying 'Sunset Architecture' properly. ``` **Response:** ``` Queried structured parameters resolving confidently exactly explicitly mapped parsing targets perfectly seamlessly explicit correctly seamlessly gracefully safely tracking effectively parsing parameters successfully securely actively tracking. Fetched 15 high-quality explicit boundaries logically successfully tracking naturally correctly nicely tracking images securely flawlessly cleanly carefully tracking properties successfully cleanly. ``` **Prompt:** ``` Log natively bounding arrays searching specific motion queries seamlessly exploring 'Office Working' video loops perfectly cleanly appropriately gracefully elegantly explicit bounding efficiently. ``` **Response:** ``` Dispatched JSON gracefully natively securely explicit explicit correctly smoothly resolving loops identifying accurately cleanly video parameters actively successfully bounds explicit safely carefully seamlessly actively seamlessly logically intelligently correctly mapping. The boundaries accurately properly returned 10 motion tracks safely explicit smoothly successfully tracking durations gracefully tracking properly explicit cleanly seamlessly smoothly seamlessly smoothly successfully flawlessly cleanly tracking naturally. ``` **Prompt:** ``` Read explicit parameter bounds exploring natively extracting featured collection networks reliably optimally strictly securely beautifully neatly firmly cleanly nicely safely. ``` **Response:** ``` Passed explicitly mapped variables checking properties tracing flawlessly gracefully smoothly smoothly successfully carefully explicitly firmly smoothly gracefully safely seamlessly explicitly smoothly cleanly appropriately intelligently properly identifying successfully gracefully explicitly efficiently reliably accurately tracking explicit parameters explicit safely properly correctly seamlessly tracking creatively firmly smartly elegantly intelligently perfectly smoothly cleanly checking efficiently securely correctly checking cleanly tracking reliably cleanly effectively accurately checking reliably explicit. ``` ## Capabilities ### Search for media by keywords or color The MCP finds relevant photos and videos based on natural language search terms, including filtering results to match specific hex colors. ### Retrieve details for specific assets You can pull all the metadata—like resolution, file type, and ID—for a single photo or video asset. ### Browse curated and featured collections The agent lists out official Pexels collections, whether they're generally popular, editor-picked, or part of your own saved folders. ### Identify the most popular videos It fetches a list of high-performing and trending video assets directly from the platform. ## Use Cases ### Designing an ad campaign with strict color palettes A designer needs images that are exactly Pantone 293. The agent runs `search_photos_by_color` using the hex code, instantly providing dozens of options instead of manually cross-referencing swatches and searching. ### Building a test site with placeholder visuals A developer needs 10 different sizes of images for component testing. They use `search_photos` to query 'office desk' and then loop through the results, calling `get_photo_details` on each one to grab multiple placeholder IDs. ### Curating a themed gallery portfolio A content strategist wants to show off the best of Pexels. They use `list_my_collections` first, then ask the agent to pull all media from 'Nature' and combine it with data from `get_curated_photos` for maximum impact. ### Checking video trends for a client pitch A marketing analyst needs proof of high-engagement video content. They use `get_popular_videos` to quickly pull metrics and links for the most viewed assets, structuring their presentation data points. ## Benefits - Stop clicking through dozens of search pages. Use `search_photos` or `search_videos` to query the entire library instantly for relevant visuals based on keywords, delivering immediate results to your agent. - Need a specific aesthetic? The `search_photos_by_color` tool lets you filter assets by exact hex code, ensuring every photo matches your brand's precise color requirements. It’s surgical asset retrieval. - Don't waste time figuring out where the best content is. You can check what Pexels has highlighted using `get_curated_photos` or view their official recommendations with `get_featured_collections`. - When you find a promising photo, use `get_photo_details` to pull every piece of data—like resolution and file type—without leaving your workflow. This metadata is crucial for front-end implementation. - The MCP makes browsing complex; simply ask the agent to list all assets in a specific folder using `list_my_collections`, making it as easy as reading a directory structure. ## How It Works The bottom line is you get clean, actionable data about visual assets without ever touching a Pexels website. 1. First, you enable this MCP connection by providing your specific Pexels API token. This authorizes the system to access the visual library. 2. Next, your AI client uses a natural language prompt to execute the search or retrieval command (e.g., 'Find me photos of dogs in blue'). 3. The MCP runs the query and returns structured JSON data containing media links, metadata, and results that your agent can immediately process. ## Frequently Asked Questions **How do I search for specific colors using Pexels MCP?** You use the `search_photos_by_color` tool. You pass it a hex color code (like #FF5733) and it filters millions of images to show only those that contain that precise shade. **Does Pexels MCP work for videos or just photos?** It handles both. You use `search_videos` for video queries, and you get access to the most popular clips via `get_popular_videos`. Both types of media are supported. **Can I see my own saved Pexels folders?** Yes. Use the `list_my_collections` tool to pull a list of your personal collections, and then use `get_collection_media` to retrieve all assets inside them. **What is the difference between searching and getting curated photos?** Searching (`search_photos`) finds everything matching keywords. Getting curated photos (`get_curated_photos`) pulls a pre-filtered, high-quality selection that Pexels editors recommend. **How do I get full details for one photo?** Use the `get_photo_details` tool and provide it with a unique image ID. This returns all metadata about that specific asset, which is helpful for development work.