Stock Images

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):

{
  "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

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