Pexels MCP Server
Provides tools for searching photos and videos using the Pexels API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pexels MCP Server search for photos of a sunset"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Pexels MCP Server
An MCP server to search for photos and videos on Pexels.
Prerequisites
Docker
Pexels API Key (Get one at https://www.pexels.com/api/)
Related MCP server: pexels-mcp-server
Building the Docker Image
Run the following command in this directory:
docker build -t pexels-mcp .Running the Server
You can run the server directly with Docker. It communicates via Stdio, so it's designed to be called by an MCP client (like Claude Desktop or the MCP Toolkit).
To test it manually or use it, you generally configure your MCP client to run the docker command:
docker run -i --rm -e PEXELS_API_KEY=your_api_key_here pexels-mcpConfiguration
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"pexels": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PEXELS_API_KEY=your_actual_api_key_here",
"pexels-mcp"
]
}
}
}Docker MCP Toolkit
If you are using the Docker MCP Toolkit, you may be able to add it via the UI by pointing to this image or running the container.
Available Tools
3 toolspexels_get_photoA
Get details for a specific photo by ID
Inputs: id (required).
pexels_search_photosC
Search for photos on Pexels
Inputs: query (required), page, per_page.
pexels_search_videosB
Search for videos on Pexels
Inputs: query (required), page, per_page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: retrieving a single photo by ID, searching photos, and searching videos. There is no overlap or ambiguity.
All tools follow the 'pexels_verb_noun' pattern consistently, making the naming predictable and easy to understand.
With only 3 tools, the server is tightly scoped to core Pexels operations. This is appropriate for a focused API wrapper.
Covers search for both photos and videos and retrieval of a specific photo, but lacks a tool to get a specific video by ID, which is a notable gap given symmetrical functionality.
Related MCP Connectors
MCP server for meme generation, template search, caption rendering, and AI meme creation.
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
MCP server for Google Veo AI video generation
MCP server for Pixapi: check live credit pricing and balance, then generate images and video.
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server to search and download stock images from Pexels, Unsplash, and Pixabay2642 npm6MIT
- AlicenseAqualityAmaintenanceAn MCP server that enables AI agents to search, retrieve, and curate free stock photos and videos from Pexels, with tools, resources, and prompts for easy integration.8MIT
- AlicenseAqualityCmaintenanceAn MCP server that searches and downloads royalty-free images from Pixabay by keyword, with support for custom image size and safe search.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to search for royalty-free images from Pexels and Unsplash using natural language, returning structured results with metadata.556 npm1MIT