Provides access to the Pexels Photos Search API, enabling photo searches with filters for orientation, size, color, and locale, plus pagination support for browsing results.
Pexels MCP Server
An MCP (Model Context Protocol) server that provides access to the Pexels Photos Search API.
Features
Search for photos using text queries
Filter by orientation (landscape, portrait, square)
Filter by size (large, medium, small)
Filter by dominant color
Pagination support
Localization support
Related MCP server: Pixabay MCP Server
Setup
Install dependencies:
Get a Pexels API key from https://www.pexels.com/api/
Set your API key as an environment variable:
Or create a .env file (copy from .env.example):
Build the project:
Usage
Running the Server
Available Tool
search_photos
Search for photos on Pexels.
Parameters:
query(required): Search term for finding photospage(optional): Page number (default: 1)per_page(optional): Number of results per page (default: 15, max: 80)orientation(optional): Filter by photo orientation (landscape,portrait,square)size(optional): Filter by photo size (large,medium,small)color(optional): Filter by dominant color (red,orange,yellow,green,turquoise,blue,violet,pink,brown,black,gray,white)locale(optional): The locale for the search (e.g.,en-US,pt-BR)
Example Response:
Claude Code Configuration
To use this MCP server with Claude Code, add it to your MCP settings:
Development
Run in development mode:
License
MIT