search_photos

Search high-quality images from Unsplash using keywords, filters, and pagination. Retrieve photo details like ID, description, URLs, and dimensions directly for integration into projects.

Instructions

Search for Unsplash photos

Args:
    query: Search keyword
    page: Page number (1-based)
    per_page: Results per page (1-30)
    order_by: Sort method (relevant or latest)
    color: Color filter (black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue)
    orientation: Orientation filter (landscape, portrait, squarish)

Returns:
    List[UnsplashPhoto]: List of search results containing photo objects with the following properties:
        - id: Unique identifier for the photo
        - description: Optional text description of the photo
        - urls: Dictionary of available image URLs in different sizes
        - width: Original image width in pixels
        - height: Original image height in pixels

Input Schema

Name	Required	Default
`color`	No
`order_by`	No	relevant
`orientation`	No
`page`	No
`per_page`	No
`query`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Color"
    },
    "order_by": {
      "default": "relevant",
      "title": "Order By",
      "type": "string"
    },
    "orientation": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Orientation"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "default": 1,
      "title": "Page"
    },
    "per_page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "default": 10,
      "title": "Per Page"
    },
    "query": {
      "title": "Query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_photosArguments",
  "type": "object"
}

Unsplash MCP Server

search_photos

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Unsplash MCP Server

Related Tools

MCP directory API