@fixrs/pexels-mcp-server

MCP (Model Context Protocol) server for the Pexels API. Search and retrieve stock photos and videos directly from your MCP-compatible client.

Installation

npx @fixrs/pexels-mcp-server
# or
npm install -g @fixrs/pexels-mcp-server

Configuration

Set the PEXELS_API_KEY environment variable with your Pexels API key.

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "pexels": {
      "command": ["node", "/path/to/dist/index.js"],
      "type": "local",
      "environment": {
        "PEXELS_API_KEY": "your-api-key"
      }
    }
  }
}

Or via npx once published:

{
  "mcp": {
    "pexels": {
      "command": ["npx", "-y", "@fixrs/pexels-mcp-server"],
      "type": "local",
      "environment": {
        "PEXELS_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

Photo Tools

| Tool | Description | Parameters | |------|-------------|------------| | search_photos | Search Pexels for photos by keyword | query (required), orientation, size, color, locale, page, per_page | | curated_photos | Get real-time curated photos, updated every hour | page, per_page | | get_photo | Retrieve a specific photo by its ID | id |

Video Tools

| Tool | Description | Parameters | |------|-------------|------------| | search_videos | Search Pexels for videos by keyword | query (required), orientation, size, locale, page, per_page | | popular_videos | Get popular/trending videos | page, per_page | | get_video | Retrieve a specific video by its ID | id |

Development

git clone https://github.com/fixrs/pexels-mcp-server
cd pexels-mcp-server
npm install
npm run build
PEXELS_API_KEY=your-key node dist/index.js

Rate Limits

The Pexels API is rate-limited to:

• 200 requests per hour
• 20,000 requests per month

License

MIT