Skip to main content
Glama
hanoak

pexels-mcp-server

by hanoak

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNodebug | info | warn | error (default info). All logs go to stderr; stdout carries only the MCP protocol.info
PEXELS_API_KEYYesYour Pexels API key. The server exits at startup with a clear message if it is missing or blank.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
pexels_search_photosA

Search Pexels for photos matching a query, with optional orientation/size/color/locale filters. Returns compact photo objects with pre-sized URLs and a courtesy credit (attribution is appreciated but not required by the Pexels license). Read-only. Each photo includes several pre-sized URLs in src (original/large2x/large/medium/small/portrait/landscape/tiny) — pick the closest fit rather than always using original.

pexels_curated_photosA

List Pexels' hand-curated photo picks, refreshed hourly (paginated). Returns compact photo objects. Read-only. Each photo includes several pre-sized URLs in src (original/large2x/large/medium/small/portrait/landscape/tiny) — pick the closest fit rather than always using original.

pexels_get_photoA

Get a single Pexels photo by its numeric ID, with full detail, pre-sized URLs, and a courtesy credit. Read-only. Each photo includes several pre-sized URLs in src (original/large2x/large/medium/small/portrait/landscape/tiny) — pick the closest fit rather than always using original.

pexels_search_videosA

Search Pexels for videos matching a query, with optional orientation/size/locale filters. Returns compact video objects with rendition links. Read-only. video_files is trimmed to the highest-resolution renditions (see video_files_count for the full count) — call pexels_get_video for the complete rendition list on one video.

pexels_popular_videosA

List currently popular Pexels videos, optionally filtered by minimum width/height and duration range. Returns compact video objects. Read-only. video_files is trimmed to the highest-resolution renditions (see video_files_count for the full count) — call pexels_get_video for the complete rendition list on one video.

pexels_get_videoA

Get a single Pexels video by its numeric ID, with full detail and every available rendition (unlike the search/popular tools, this returns the complete video_files list, not just the top few). Read-only.

pexels_list_featured_collectionsA

List Pexels' featured collections (paginated). Returns collection metadata only — call pexels_get_collection_media for the photos/videos inside one. Read-only.

pexels_list_my_collectionsA

List the collections belonging to the Pexels account that owns the configured API key (paginated). Since Pexels has no per-conversation OAuth login, this always reflects the API key's own account, not the person chatting — it will be empty unless that account has created collections on pexels.com. Read-only.

pexels_get_collection_mediaA

Get the photos and/or videos inside a Pexels collection by its ID (paginated, optionally filtered to just photos or just videos). Each item is returned in the same compact shape its own domain tool would use, tagged with media_type. Read-only. Each photo includes several pre-sized URLs in src (original/large2x/large/medium/small/portrait/landscape/tiny) — pick the closest fit rather than always using original. video_files is trimmed to the highest-resolution renditions (see video_files_count for the full count) — call pexels_get_video for the complete rendition list on one video.

Prompts

Interactive templates invoked by user choice

NameDescription
find_photoSearch Pexels for a photo matching a description and present it with a courtesy credit.
photo_gallerySearch Pexels for a themed set of photos and present them all with courtesy credits.
find_videoSearch Pexels for a video matching a description and present it with a courtesy credit.
collection_tourFind a featured Pexels collection matching a theme and walk through its media.
media_briefGather both photos and videos for a theme and present them together as a brief.

Resources

Contextual data attached and managed by the client

NameDescription
usage-guideWhat is and isn't allowed when using Pexels photos/videos from this server: the real license restrictions, optional attribution, and content-safety notes.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hanoak/pexels-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server