mcp-server-pexels
An MCP server for Pexels stock photo and video search. Optimized for LLMs.
Pexels provides free stock photos and videos.
Features
- Photo Search — Search photos with filters (query, orientation, size, color, locale)
- Video Search — Search videos, auto-selects HD .mp4 closest to 1920x1080
- Get Details — Retrieve full metadata for a photo/video by ID
- Intelligent Caching — 10 min TTL for searches, 60 min for ID lookups
- Error Handling — Graceful failures with helpful messages (per MCP best practices)
- Attribution — Mandatory photographer credits in every result
For LLM agents: See
docs/agents/AGENTS.mdfor agent-optimized documentation — tool semantics, caching behaviour, response structure, and attribution requirements.
Prerequisites
- Node.js v20+
- Pexels API key (free at pexels.com/api)
Quick Start (2 minutes)
1. Get an API Key
Sign up at pexels.com/api — free, no credit card.
2. Build the Server
npm install && npm run build3. Add to Claude Desktop
Open ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows), add:
