# Pexels — MCP server on mcp.ai
> Connect your Pexels account and use 9 tools for images and design straight from your AI agent. Connect with your own API key. Pexels offers a free API that provides access to a vast library of high-quality photos and videos, enabling seamless integration into applications and websites.

By: mcp.ai · official
Page: https://mcp.ai/pexels

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_pexels?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/pexels/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/pexels/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/pexels/skill.md
Postman collection (v2.1): https://mcp.ai/pexels/postman.json

## Tools
- pexels_collection_media(id: string, page?: integer, per_page?: integer) — Tool to get all media within a collection by its ID. Use when you need to fetch paginated media from a specific collection.
- pexels_curated_photos(page?: integer, per_page?: integer) — Tool to get real-time curated photos. Use when you need to fetch curated photos with pagination support.
- pexels_featured_collections(page?: integer, per_page?: integer) — Tool to get featured collections. Use when you need curated collections of photos and videos with pagination support.
- pexels_get_photo(id: integer) — Tool to retrieve detailed information about a specific photo. Use when you have a valid photo ID to fetch metadata including dimensions, photographer details, and image URLs. Use after confirming the 
- pexels_get_video_by_id(id: integer) — Tool to retrieve detailed information about a specific video from Pexels. Use when you have a valid video ID to fetch metadata including dimensions, duration, videographer details, and available video
- pexels_my_collections(page?: integer, per_page?: integer) — Tool to get all of the user's collections on Pexels. Use when you need to list a user's collections with pagination support.
- pexels_popular_videos(page?: integer, per_page?: integer) — Tool to retrieve current popular Pexels videos. Use when you want to fetch trending videos from Pexels.
- pexels_search_photos(page?: integer, size?: string, color?: string, query: string, locale?: string, per_page?: integer, orientation?: string) — Tool to search for photos on Pexels. Use when you need to retrieve photos by a search term and optional filters. Call after confirming you have a valid Pexels API key. Response image URLs are nested u
- pexels_search_videos(page?: integer, size?: string, query: string, per_page?: integer, orientation?: string) — Tool to search for videos on Pexels by query and optional filters. Use when you need to find relevant video assets. Combining multiple filters with a narrow query may return few or no results; only ap

## Example prompts
- "What can I do in Pexels?"
- "Show me a summary of my Pexels account"

## Links
Docs: https://mcp.ai/docs/mcps/pexels
Website: https://mcp.ai/mcps/pexels