Unsplash MCP server for AI agents
Let Claude, ChatGPT or your own agent read Unsplash: 1 typed function through one MCP server. No Unsplash API key needed.
- Site
- unsplash.com
- Functions
- 1
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Unsplash
An MCP server for Unsplash alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/unsplashEvery site
One MCP server for Unsplash and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 1
searchSearches Unsplash's photo library by keyword and returns the first page of photos with image URLs, size, photographer and whether each is free or…Arguments
Name Type Required querystringYes Returns
UnsplashSearchResultinterface UnsplashPhoto { id: string; /** The photographer's caption, else Unsplash's generated alt text. */ description: string | null; width: number; height: number; /** Dominant colour, "#rrggbb". */ color: string | null; /** raw is the original; append imgix params ("&w=1600") to size it. regular is 1080px wide. */ urls: { raw: string; full: string; regular: string; small: string; thumb: string }; /** The photo's own page on unsplash.com. */ pageUrl: string; likes: number; /** true = Unsplash+ (paid, separate licence, NOT free to use). */ premium: boolean; photographer: { name: string; username: string; profileUrl: string | null }; } interface UnsplashSearchResult { /** Matches across every page. */ total: number; /** The first page (up to 20), in Unsplash's relevance order. */ photos: UnsplashPhoto[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/unsplash/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.unsplash.search("mountain lake");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.unsplash.search("mountain lake"))curl -X POST https://api.bowmark.ai/v1/sites/unsplash/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"mountain lake"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.unsplash.search("mountain lake");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/unsplash/<function> - OpenAPI
/v1/sites/unsplash/openapi.json