leo-unsplash-mcp
Provides wallpaper search integration with Unsplash, allowing queries and orientation to fetch photos with details like download URL, description, and photographer.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@leo-unsplash-mcpfind me a wallpaper of a mountain landscape in landscape orientation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
leo-unsplash
Unsplash wallpapers as a Leo provider package, over MCP.
Leo's wallpaper generator doesn't do this itself — it resolves a provider and asks that. This server is one, reachable as a package the hub installs at runtime rather than one it has to be rebuilt for.
What it answers
The wallpaper role in leo_mcp::providers:
search_photos({ queries, orientation })
-> { photos: [{ source_id, download_url, description, photographer }] }Results come back as JSON in a text content block, which is the convention the hub's bridge reads.
Related MCP server: Unsplash Smart MCP Server
Configuration
Handed to this process by Leo as environment variables under their settings
keys, verbatim and lower-case — only the keys the descriptor declares in
entitlements.settings_read and the owner consented to, never the whole
settings table.
env | where it comes from |
| Settings → Packages → Unsplash |
Note the key is unsplash_access_key, not *_api_key — it matches the
compiled package's settings key.
With nothing configured the tool returns isError naming the setting. That is
deliberate: an empty answer would reach Leo as a real result.
Running it
npm install
node index.js # speaks MCP over stdio
npm test # checks the response mapping, no network neededWhy plain JavaScript
This ships as a git tarball pinned to a commit SHA, and npm does not reliably run build steps for a tarball URL. A TypeScript source tree would install and then fail to start on somebody else's machine, where it is hardest to diagnose.
The registry entry must name a full 40-character commit SHA. A tag reads as equally specific and is not — it can be moved after the entry is reviewed.
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
AI-powered image processing via GPU. Remove backgrounds and upscale images (2x/4x) directly from any MCP client. OAuth 2.1 authenticated, returns processed images inline with download links. Free credits on signup at maskr.io.
Search, preview, and measure Umbra open SAR from any MCP client. Umbra ships no search API.
Search over 1.85 million captioned images using text, a reference image, or both. Upload a JPEG, PNG, or WebP image as base64, or provide a public HTTPS image URL. Find similar images from a Lightdrift asset ID and retrieve hosted file URLs, source licenses, and attribution. Connect with OAuth or an API key. Searches cost $0.005 ($5 per 1,000); image details are free. Setup: https://docs.lightdrift.ai/guides/images-mcp
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides access to the Unsplash API, enabling AI assistants to search and retrieve high-quality photos, browse collections, view photographer profiles, and get photo statistics with advanced filtering options.52 npmMIT
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to search, recommend, and deliver professional stock photos from Unsplash with intelligent context awareness and automatic attribution management.11 npm64MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.52 npm1MIT
- AlicenseAqualityDmaintenanceMCP server that enables searching and downloading Unsplash photos and collections.4MIT