# Stock Images MCP
<a href="https://glama.ai/mcp/servers/@jeanpfs/stock-images-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@jeanpfs/stock-images-mcp/badge" />
</a>
An MCP (Model Context Protocol) server for searching and downloading stock images from Pexels, Unsplash, and Pixabay.
## Features
- **search_images**: Search across multiple stock image providers
- **download_image**: Download images to local folder
## Setup
### Get API Keys (at least one required)
- **Pexels**: https://www.pexels.com/api/
- **Unsplash**: https://unsplash.com/developers
- **Pixabay**: https://pixabay.com/api/docs/
### Usage with Claude Code / Cursor
Add to your MCP config (`~/.claude/mcp.json` or `~/.cursor/mcp.json`):
```json
{
"mcpServers": {
"stock-images": {
"command": "npx",
"args": ["-y", "stock-images-mcp"],
"env": {
"PEXELS_API_KEY": "your-key-here",
"UNSPLASH_API_KEY": "your-key-here",
"PIXABAY_API_KEY": "your-key-here"
}
}
}
}
```
### Usage with Docker
```bash
docker build -t stock-images-mcp .
docker run -e PEXELS_API_KEY=xxx stock-images-mcp
```
## Tools
### search_images
Search for stock images across configured providers.
**Parameters:**
- `query` (required): Search term
- `provider`: "pexels", "unsplash", "pixabay", or "all" (default: "all")
- `count`: Number of results per provider (default: 5, max: 20)
- `orientation`: "landscape", "portrait", or "square"
### download_image
Download an image to local folder.
**Parameters:**
- `url` (required): Image URL
- `filename`: Output filename (auto-generated if omitted)
- `folder`: Destination folder (default: "./downloads")
## License
MIT
