SkillAgentSearch skills...

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-pexels

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

78/100

Supported Platforms

Claude Code
Claude Desktop
Cursor
Cline

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
11/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
mcp-pexels (this skill)by developer-ishan7836mo agoMCP Server
claude-memby thedotmack100117.6ktodayCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.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.

mcp-pexels — Pexels MCP server for Claude, Cursor, and other AI agents

npm version npm downloads CI license: MIT Node ≥20 MCP compatible

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?

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_videos with 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-pixel boxes.
  • 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 fetch and --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

View on GitHub
GitHub Stars3
CategoryAI
Updated6mo ago
Forks0

Languages

TypeScript

Trust signals

86/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

2 low