mcp-pexels
Pexels MCP server — search and fetch free stock photos, videos, and curated collections from Pexels inside Claude, Cursor, Cline, and other Model Context Protocol clients.
Install / Use
claude mcp add developer-ishan -- npx -y github:developer-ishan/mcp-pexelsIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of mcp-pexels
mcp-pexels scores 78/100 on our quality scale, 786th of 947 AI & Machine Learning skills we index.
Its MCP Server is 14 KB long, well organised into 34 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-12 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 86/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
mcp-pexels compared with similar skills
All 4 of these similar skills score higher than mcp-pexels; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp-pexels (this skill)by developer-ishan | 78 | 3 | 6mo ago | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install mcp-pexels?
- Run
claude mcp add developer-ishan -- npx -y github:developer-ishan/mcp-pexels. The install tabs above show the steps for each supported agent. - Which AI agents does mcp-pexels work with?
- It is written for Claude Code, Claude Desktop, Cursor and Cline, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mcp-pexels safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mcp-pexels still maintained?
- The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubmcp-pexels — Pexels MCP server for Claude, Cursor, and other AI agents
A Model Context Protocol server that exposes the Pexels API — free stock photos, videos, and curated collections — as MCP tools that any compatible AI client (Claude Desktop, Claude Code, Cursor, Cline, Continue, etc.) can call directly from a chat.
📦 npm: mcp-pexels · 🏷 Latest release: v1.0.0 · 💻 Source: developer-ishan/mcp-pexels
Photos & videos provided by Pexels.
Drop-in config
{
"mcpServers": {
"pexels": {
"command": "npx",
"args": ["-y", "mcp-pexels"],
"env": { "PEXELS_API_KEY": "your_key_here" }
}
}
}
Paste into your MCP client's config, restart, and the nine pexels_* tools are live. Get a free key at https://www.pexels.com/api/.
Table of contents
- What can you build with this?
- Capabilities — nine tools
- Connect to your MCP client
- Example prompts
- How it compares
- FAQ
- Requirements
- Development
- Releasing
- Contributing
- Attribution & License
What can you build with this?
Once mcp-pexels is connected to an AI client, the agent can pull royalty-free photos and videos straight into its workflow. A few concrete uses:
- Slide-deck and document illustration — "Find me a landscape photo of mountains at sunset for slide 3" → the agent searches Pexels, picks one, and embeds it.
- Blog post / social media drafting — "Suggest three thumbnail options for an article about remote work" → returns three Pexels URLs with photographer credit.
- Background research for video editing — "Show me popular drone footage under 30 seconds in 4K" → uses
pexels_popular_videoswith size and duration filters. - Mood boards — "Build me a mood board of warm-toned coffee shop photos" → searches with
color: "orange". - Coding agents — generate CSS/HTML with realistic placeholder imagery instead of
lorem-pixelboxes. - Curated collections — pull a specific Pexels collection (e.g. company-owned shots tagged on Pexels) into the agent's context.
Because every response includes a _rateLimit object, the agent can self-throttle and respect the Pexels free-tier quota (200 req/hour, 20 000/month).
Capabilities — nine tools
| Domain | Tool | What it does |
|---|---|---|
| Photos | pexels_search_photos | Search photos by query with orientation / size / color / locale filters. |
| Photos | pexels_curated_photos | Fetch the Pexels team's real-time curated photo feed. |
| Photos | pexels_get_photo | Retrieve a single photo by its numeric id. |
| Videos | pexels_search_videos | Search videos by query with orientation / size / locale filters. |
| Videos | pexels_popular_videos | Fetch popular videos with optional width / height / duration constraints. |
| Videos | pexels_get_video | Retrieve a single video by its numeric id. |
| Collections | pexels_featured_collections | List Pexels featured collections. |
| Collections | pexels_my_collections | List the authenticated user's own collections. |
| Collections | pexels_collection_media | Retrieve the photos and videos inside a specific collection. |
Each tool response is the raw Pexels JSON merged with a top-level _rateLimit field exposing limit, remaining, and reset (UNIX timestamp).
See docs/tools/ for per-tool parameter tables and example payloads.
Connect to your MCP client
All paths below use npx -y mcp-pexels — no global install required. Replace your_key_here with a real Pexels API key.
Claude Desktop
Option 1 — one-click .mcpb install (recommended). Download the latest mcp-pexels-*.mcpb from the Releases page, double-click the file, paste your Pexels API key when Claude Desktop prompts, and click Install.
Option 2 — manual JSON config. Edit claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"pexels": {
"command": "npx",
"args": ["-y", "mcp-pexels"],
"env": { "PEXELS_API_KEY": "your_key_here" }
}
}
}
Restart Claude Desktop.
Claude Code
claude mcp add pexels -e PEXELS_API_KEY=your_key_here -- npx -y mcp-pexels
Or edit ~/.claude.json directly and add the same mcpServers block as above.
Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):
{
"mcpServers": {
"pexels": {
"command": "npx",
"args": ["-y", "mcp-pexels"],
"env": { "PEXELS_API_KEY": "your_key_here" }
}
}
}
Cline (VS Code)
Open the Cline extension settings → MCP Servers → Edit Settings. Add:
{
"mcpServers": {
"pexels": {
"command": "npx",
"args": ["-y", "mcp-pexels"],
"env": { "PEXELS_API_KEY": "your_key_here" }
}
}
}
Continue.dev
In ~/.continue/config.json:
{
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-pexels"],
"env": { "PEXELS_API_KEY": "your_key_here" }
}
}
]
}
}
Generic / other clients
If your client supports stdio MCP servers it just needs command, args, and env. Use the same shape as Cursor / Claude Desktop above. For inspector / debugging:
export PEXELS_API_KEY=your_key_here
npx -y @modelcontextprotocol/inspector npx -y mcp-pexels
This opens a browser UI where you can call each tool interactively.
Example prompts
Once connected, try prompts like:
- "Find me five landscape photos of mountains at golden hour. Make sure they're at least full HD."
- "Get me popular Pexels videos shorter than 15 seconds, 1080p or higher, of city traffic."
- "Pull photo id 2014422 and tell me the photographer."
- "List the featured Pexels collections — I want one I can browse for cooking photos."
- "Search videos of 'forest' in portrait orientation; pick the highest-quality HD file for me."
- "Show me Pexels photos with predominantly orange tones suitable for a fall-themed newsletter header."
The agent will pick the appropriate tool, send the right parameters, and include photographer/videographer credit as part of its answer.
How it compares
| | mcp-pexels | Raw Pexels REST API | Image-only general MCP servers |
|---|---|---|---|
| Photos | ✅ | ✅ | varies |
| Videos | ✅ | ✅ | usually ❌ |
| Collections | ✅ | ✅ | ❌ |
| Rate-limit headers exposed to agent | ✅ | ❌ (raw headers, agent must parse) | ❌ |
| Zod-validated input | ✅ | ❌ | varies |
| npx-installable, zero config | ✅ | ❌ | varies |
| Type-safe TS source | ✅ | n/a | varies |
| MIT-licensed | ✅ | n/a | varies |
If you only need photos and you already have a generic image MCP server wired up, that may be enough. If you want first-class video and collection support with rate-limit awareness, this is purpose-built for it.
FAQ
How do I get a Pexels API key?
Sign up at https://www.pexels.com/api/ — keys are issued instantly and the free tier allows 200 requests/hour and 20 000 requests/month.
Does this cost anything?
No. The Pexels API is free, the npm package is free (MIT), and mcp-pexels itself does not call any paid service.
Will this work offline?
No — the server is a thin wrapper over the Pexels HTTPS API and requires network access.
Can I use Pexels content commercially?
Yes, per the Pexels license, but you must attribute the platform and (when possible) the photographer. See Attribution.
Does it work with Claude.ai (browser)?
Claude.ai's web product doesn't yet support stdio MCP servers — only Claude Desktop, Claude Code, and the API do. Anthropic is rolling out browser MCP support, so this should change.
Is there a hosted / SaaS version?
No. Run it locally via npx. Because Pexels API keys are per-user, hosting a shared instance doesn't make sense.
How do I update to a newer version?
npx always fetches the latest published version. If you've installed globally, run npm update -g mcp-pexels.
Can I add more Pexels endpoints?
The Pexels API surface is fully implemented (9/9 endpoints as of Pexels API v1). New endpoints will be added via PR — see Contributing.
Does it work with @modelcontextprotocol/inspector?
Yes:
export PEXELS_API_KEY=your_key_here
npx -y @modelcontextprotocol/inspector npx -y mcp-pexels
How is rate limiting handled?
Every tool response includes a _rateLimit object with limit, remaining, and reset (UNIX timestamp). The agent can read this and self-throttle. If Pexels returns 429, the server surfaces it as a PexelsApiError so the agent sees the failure.
Where does my API key go?
It is read from the PEXELS_API_KEY env var on the local process. It never leaves your machine except in Authorization headers to api.pexels.com. Nothing is logged.
Requirements
- Node.js ≥ 20 (uses native
fetchand--env-file) - A free Pexels API key — request one here
Development
git clone https://github.com/developer-ishan/mcp-pexels.git
cd mcp-pexels
npm install
echo "PEXELS_API_KEY=your_key_here" > .env
npm test # 42 mocked vitest cases, no network
npm run build # tsc → dist/
npm run dev # tsx watch
npm run test:watch # vitest in watch mode
npm start # node --env-file=.env dist/index.js
Project layout
src/
├── index.ts # MCP server entrypoint (stdio)
├── http/
│ ├── client.ts # PexelsClient (injectable fetch for tests)
│ └── types.ts # PexelsApiError, RateLimit, PexelsResponse
├── tools/
│ ├── index.ts # composes the three domain factories
│ ├── photos.ts # 3 photo tools
│ ├── videos.ts # 3 video tools
│ └── collections.ts # 3 collection tools
└── types/
├── tool.ts # defineTool helper + ToolDefinition
├── photos.ts
├──
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
