Skip to main content
Glama

Unsplash MCP Server and API by Cotlet

Search collections in Unsplash

unsplash_search_collections
Read-onlyIdempotent

Search collections in the user's own Unsplash account from ChatGPT, Claude or any AI agent. Returns how to do it in Unsplash step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Unsplash Cloud Browser. Unsplash's official API: Yes, Unsplash has a public REST API (v1) for photos, collections, users and topics, and an official hosted MCP server at mcp.unsplash.com listed in the Claude directory (checked 6 Nov 2026).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "unsplash_search_collections"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With readOnlyHint and destructiveHint=false already declared, the description usefully adds "opens nothing by itself", confirming no browser session is launched as a side effect. The closing sentence about Unsplash's official REST API and hosted MCP server is unrelated to invoking this tool and crowds out more relevant behavior detail such as what the step-by-step response actually contains.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first two sentences do the work, but the third is an off-topic aside about Unsplash's public API and an official MCP server, including a verification date, which gives the calling agent nothing actionable. Roughly a third of the description is wasted on this digression.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description carries the burden of explaining the return value; it says the tool returns screens, buttons and fields step by step, which is partially helpful. It still never clarifies whether any collection data is returned alongside those instructions, leaving the contract for a zero-parameter tool only half specified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is nothing for the description to disambiguate; the schema is fully self-sufficient here. The baseline of 4 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening states a specific verb and resource ("Search collections in the user's own Unsplash account"), but the next sentence reframes the tool as returning step-by-step instructions on how to search rather than performing the search. That ambiguity leaves the agent unsure whether it will receive results or a how-to guide, and no sibling (unsplash_search_photos, unsplash_list_collection_photos) is named for differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is real guidance in "then do it with the cotlet_browser_* tools in the user's Unsplash Cloud Browser", which tells the agent the search must actually be completed through browser tools. However, it never says when to choose this tool over unsplash_search_photos or unsplash_list_collection_photos, nor what prerequisites the user's account needs.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources