# pexels

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/codeChap/mcp-server-pexels  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pexels

## Description
MCP server for Pexels — search photos and videos, and browse collections

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "pexels": {
    "command": "npx",
    "args": ["-y","pexels"]
  }
}
```

## Documentation & README

# mcp-server-pexels

An MCP (Model Context Protocol) server for the Pexels API. Built in Rust, exposes photo search, video search, and curated/featured content as MCP tools.

Communicates via stdio using JSON-RPC 2.0.

## Tools

| Tool | Description |
|------|-------------|
| `search_photos` | Search photos by query with optional orientation/size/color/locale filters |
| `curated_photos` | Get a paginated list of curated, hand-picked photos |
| `get_photo` | Retrieve a single photo by ID |
| `search_videos` | Search videos by query with optional orientation/size/locale filters |
| `popular_videos` | Get popular videos with optional dimension and duration filters |
| `get_video` | Retrieve a single video by ID |
| `featured_collections` | List featured collections (themed sets of media) |
| `collection_media` | List media in a specific collection (filterable by photos/videos) |

## Prerequisites

- Rust (edition 2024)
- A Pexels API key from [pexels.com/api](https://www.pexels.com/api/)

## Setup

```bash
mkdir -p ~/.config/mcp-server-pexels
```

Create `~/.config/mcp-server-pexels/config.toml`:

```toml
api_key = "your-pexels-api-key"
```

## Build

```bash
cargo build --release
```

Produces `target/release/mcp-server-pexels`.

## MCP configuration

```json
{
  "mcpServers": {
    "pexels": {
      "command": "/path/to/mcp-server-pexels"
    }
  }
}
```

## Project structure

```
src/
  main.rs    - entry point, config loading, stdio transport
  server.rs  - MCP tool definitions
  api.rs     - Pexels HTTP client and response types
  params.rs  - tool parameter types
  config.rs  - TOML config loading
```

## License

MIT