Skip to main content
Glama
Sign In
Pexels MCP Server

Pexels MCP Server

by nikola-arman
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Pexels MCP Server

An MCP (Model Context Protocol) server that provides access to the Pexels Photos Search API.

Features

  • Search for photos using text queries

  • Filter by orientation (landscape, portrait, square)

  • Filter by size (large, medium, small)

  • Filter by dominant color

  • Pagination support

  • Localization support

Related MCP server: mcp-server-pexels

Setup

  1. Install dependencies:

npm install

  1. Get a Pexels API key from https://www.pexels.com/api/

  2. Set your API key as an environment variable:

export PEXELS_API_KEY=your_api_key_here

Or create a .env file (copy from .env.example):

cp .env.example .env
# Edit .env with your API key

  1. Build the project:

npm run build

Usage

Running the Server

npm start

Available Tool

search_photos

Search for photos on Pexels.

Parameters:

  • query (required): Search term for finding photos

  • page (optional): Page number (default: 1)

  • per_page (optional): Number of results per page (default: 15, max: 80)

  • orientation (optional): Filter by photo orientation (landscape, portrait, square)

  • size (optional): Filter by photo size (large, medium, small)

  • color (optional): Filter by dominant color (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white)

  • locale (optional): The locale for the search (e.g., en-US, pt-BR)

Example Response:

{
  "success": true,
  "data": {
    "total_results": 8000,
    "page": 1,
    "per_page": 15,
    "photos": [
      {
        "id": 415829,
        "width": 2651,
        "height": 3976,
        "url": "https://www.pexels.com/photo/nature-red-love-romantic-415829/",
        "photographer": "Pixabay",
        "photographer_url": "https://www.pexels.com/@pixabay",
        "avg_color": "#C0392B",
        "alt": "Red rose",
        "src": {
          "original": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg",
          "large": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
          "medium": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=350",
          "small": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=130",
          "tiny": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=200&w=280"
        }
      }
    ],
    "next_page": "https://api.pexels.com/v1/search?query=nature&page=2"
  }
}

Claude Code Configuration

To use this MCP server with Claude Code, add it to your MCP settings:

{
  "mcpServers": {
    "pexels": {
      "command": "node",
      "args": ["/path/to/pexels-mcp-server/dist/index.js"],
      "env": {
        "PEXELS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

Run in development mode:

npm run dev

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers