Integration

Unsplash integration

Unsplash is the internet's source of freely-usable images. The Unsplash API provides access to the world's largest open collection of high-quality photos with powerful search, random photo retrieval, and user/collection management.

Connect Unsplash How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Unsplash.Built from the 32 Unsplash tools below, on the connection you add once.

Common Unsplash use cases

Discover curated galleries
Browse collections
Display topic page
Find photographers
Rename a collection
Browse latest photos
Save favorite photos
Show related content
Display topic gallery
Remove from favorites

What you can do with Unsplash

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Collection, 10 operations

add_photo_to_collectionAdd photo to collectionPOSTAdd photo to collection
create_collectionCreate collectionPOSTCreate a collection
delete_collectionDelete collectionDELETEDelete a collection
get_collectionGet collectionGETGet collection details
get_related_collectionsGet related collectionsGETGet related collections
get_user_collectionsGet user collectionsGETGet user's collections
list_collectionsList collectionsGETList all collections
remove_photo_from_collectionRemove photo from collectionDELETERemove photo from collection
search_collectionsSearch collectionsGETSearch collections
update_collectionUpdate collectionPUTUpdate a collection

Photo, 10 operations

get_collection_photosGet collection photosGETGet collection photos
get_photoGet photoGETGet photo details
get_photo_statisticsGet photo statisticsGETGet photo statistics
get_random_photoGet random photoGETGet random photo
get_topic_photosGet topic photosGETGet topic photos
get_user_likesGet user likesGETGet user's liked photos
get_user_photosGet user photosGETGet user's photos
list_photosList photosGETList all photos
search_photosSearch photosGETSearch photos
update_photoUpdate photoPUTUpdate photo info

User, 5 operations

get_current_userGet current userGETGet current user profile
get_userGet userGETGet user profile
get_user_statisticsGet user statisticsGETGet user statistics
search_usersSearch usersGETSearch users
update_current_userUpdate current userPUTUpdate current user profile

Like, 2 operations

like_photoLike photoPOSTLike a photo
unlike_photoUnlike photoDELETEUnlike a photo

Stat, 2 operations

get_stats_monthGet stats monthGETGet monthly stats
get_stats_totalsGet stats totalsGETGet total stats

Topic, 2 operations

get_topicGet topicGETGet topic details
list_topicsList topicsGETList all topics

Download, 1 operation

track_downloadTrack downloadGETTrack photo download

Unsplash API rate limits

50 requests per hour

Demo apps limited to 50 req/hour. Production apps can request higher limits.

These are the limits Unsplash documents, not ones LiveContext measured. They can change and often depend on your plan, so check the Unsplash documentation for current values.

Use Unsplash from Claude Code, Cursor or Codex

Connect Unsplash in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Unsplash operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Unsplash

Create your workspace
Sign up free. Nothing to install.
Connect Unsplash once
Add your Unsplash connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Unsplash integration FAQ

What can you do with the Unsplash integration?

LiveContext exposes 32 operations on Unsplash, covering collection, photo, user and like. Common uses include Discover curated galleries, Browse collections and Display topic page.

What are the Unsplash API rate limits?

Unsplash documents 50 requests per hour. Demo apps limited to 50 req/hour. Production apps can request higher limits. Limits are set by Unsplash and can depend on your plan.