Skip to main content
Glama
leo-unsplash-mcp

leo-unsplash-mcp

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

unsplash_access_key

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 needed

Why 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides 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.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.
      46 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables searching and downloading Unsplash photos and collections.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides Pexels wallpaper search functionality as a Leo provider package, returning photo results with download URLs and metadata.
      MIT