Unsplash MCP Server Usage Example

Query Example

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

Setup Requirements

The Unsplash MCP server requires an API access key to be configured:

1. Get an Unsplash API Key:

   • Sign up at https://unsplash.com/developers
   • Create an application
   • Copy your Access Key

2. Configure the Environment Variable:

   • Set UNSPLASH_ACCESS_KEY environment variable
   • Or configure it in your MCP server settings

Error Encountered

Error calling tool 'search_photos': Missing UNSPLASH_ACCESS_KEY environment variable

Tool Parameters

• query (required): Search keyword
• per_page (optional, default: 10): Results per page (1-30)
• page (optional, default: 1): Page number (1-based)
• order_by (optional, default: "relevant"): Sort method ("relevant" or "latest")
• orientation (optional): Orientation filter ("landscape", "portrait", "squarish")
• color (optional): Color filter (e.g., "black_and_white", "blue", "green", etc.)