# Pexels

> Pexels is a freemium MCP server for design and media. Search and fetch Pexels stock photos, videos and collections through an MCP gateway. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/pexels
- **Repository:** https://github.com/pipeworx-io/mcp-pexels
- **MCP Registry name:** io.github.pipeworx-io/pexels
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

The README describes this as an unofficial MCP integration with Pexels covering photo and video search, curated photo and video feeds, and featured collections. Each tool returns image or video file URLs at several sizes or resolutions along with photographer or videographer attribution, so results can be used with credit.

The server is hosted on the Pipeworx gateway, which exposes the Pexels tools alongside shared gateway tools such as ask_pipeworx. It can be added to a client over streamable HTTP, or run locally from npm as a stdio bridge that forwards calls to the same endpoint. An optional Pipeworx API key raises the daily call limit for anonymous use.

The pack suits developers and agent builders who want an AI client to find stock media by keyword, orientation or colour, or to pull metadata for a specific Pexels photo or video by id.

## Features

- **Photo keyword search:** Finds Pexels photos by keyword with filters for orientation, size, colour and locale.
- **Video search and feeds:** Searches Pexels videos by keyword and lists the popular video feed, with duration and resolution data.
- **Sized image and file URLs:** Returns photo images in several sizes and video files at multiple resolutions.
- **Attribution details:** Includes photographer or videographer names and links for credit.
- **Curated collections:** Lists featured collections and retrieves the mixed photos and videos inside each one.
- **Single-item metadata:** Fetches full details for one photo or video by its numeric id, including alt text and dimensions.

## Good for

- Letting an AI assistant find stock photos for a blog post or slide deck
- Pulling video clips matching a keyword for a content pipeline
- Retrieving attribution data alongside Pexels images
- Browsing Pexels curated collections from a coding agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pexels https://gateway.pipeworx.io/pexels/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/pexels/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pexels": {
      "url": "https://gateway.pipeworx.io/pexels/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pexels": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/pexels/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pexels": {
      "serverUrl": "https://gateway.pipeworx.io/pexels/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pexels": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/pexels/mcp"
    }
  }
}
```

## Tools

- `photo_search`: Search Pexels photos by keyword with optional filters.
- `photo_curated`: Fetch the curated editorial photo feed.
- `photo`: Fetch full metadata for one photo by id.
- `video_search`: Search Pexels videos by keyword.
- `video_popular`: Fetch the popular video feed.
- `video`: Fetch full metadata for one video by id.
- `featured_collections`: List featured Pexels collections.
- `collection_media`: Fetch photos and videos inside a collection by id.

## FAQ

### Is this an official Pexels integration?

No. The README states it is an independent, unofficial integration not affiliated with or endorsed by Pexels.

### Do I need an API key to use it?

No. Calls work anonymously with a daily cap of 50. A free Pipeworx account raises the cap to 200 calls per day, and the README notes the key is optional.

### Which transports does it support?

The registry lists a hosted streamable-HTTP endpoint and an npm package that runs over stdio.

### How many tools does the endpoint list?

The pack defines 8 Pexels tools. The README says a single-pack endpoint also lists roughly 30 shared gateway tools.

### Is Pexels free?

Pexels has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Pexels to Claude Code?

Run this command in your terminal: claude mcp add --transport http pexels https://gateway.pipeworx.io/pexels/mcp

### What are the best alternatives to Pexels?

The closest alternatives to Pexels are Pixabay, Unsplash, Design Feeds and Pexafy Stock Photos.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Pixabay](https://ai-powered.com/mcp/pixabay): Pixabay is a freemium MCP server for design and media.
- [Unsplash](https://ai-powered.com/mcp/unsplash): Unsplash is a freemium MCP server for web search and scraping.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Pexafy Stock Photos](https://ai-powered.com/mcp/pexafy-stock-photos): Pexafy Stock Photos is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/pexels-3
