Stock Images MCP Server

by jeanpfsio.github.jeanpfs/stock-images-mcpv2.0.0

Search and download free stock images from Pexels, Unsplash, and Pixabay.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Stock Images MCP server

claude mcp add stock-images -e PEXELS_API_KEY='<pexels-api-key>' -e UNSPLASH_API_KEY='<unsplash-api-key>' -e PIXABAY_API_KEY='<pixabay-api-key>' -- npx -y stock-images-mcp

{
  "mcpServers": {
    "stock-images": {
      "command": "npx",
      "args": [
        "-y",
        "stock-images-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "<pexels-api-key>",
        "UNSPLASH_API_KEY": "<unsplash-api-key>",
        "PIXABAY_API_KEY": "<pixabay-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "stock-images": {
      "command": "npx",
      "args": [
        "-y",
        "stock-images-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "<pexels-api-key>",
        "UNSPLASH_API_KEY": "<unsplash-api-key>",
        "PIXABAY_API_KEY": "<pixabay-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "stock-images": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "stock-images-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "<pexels-api-key>",
        "UNSPLASH_API_KEY": "<unsplash-api-key>",
        "PIXABAY_API_KEY": "<pixabay-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "stock-images": {
      "command": "npx",
      "args": [
        "-y",
        "stock-images-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "<pexels-api-key>",
        "UNSPLASH_API_KEY": "<unsplash-api-key>",
        "PIXABAY_API_KEY": "<pixabay-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PEXELS_API_KEY	—	yes	API key from pexels.com/api (free). At least one provider key is required.
UNSPLASH_API_KEY	—	yes	Access key from unsplash.com/developers (free). Required to download Unsplash photos.
PIXABAY_API_KEY	—	yes	API key from pixabay.com/api/docs (free).
STOCK_IMAGES_DOWNLOAD_DIR	—	—	Directory where download_image saves files (default: ./downloads).

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v2.0.0

FAQ

›How do I install the Stock Images MCP server in Claude Code?

Run: claude mcp add stock-images -e PEXELS_API_KEY='<pexels-api-key>' -e UNSPLASH_API_KEY='<unsplash-api-key>' -e PIXABAY_API_KEY='<pixabay-api-key>' -- npx -y stock-images-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Stock Images require an API key?

Yes. It expects PEXELS_API_KEY, UNSPLASH_API_KEY, PIXABAY_API_KEY, of which 3 are secrets.

›Can I use Stock Images as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Stock Images in the official MCP registry?

Yes, as io.github.jeanpfs/stock-images-mcp.