How to Use the Unsplash MCP in Google ADK

Q: How do I build a reliable content ingestion flow from Unsplash using the Google ADK?

Start by calling listeditorialtopics to map out available categories. Then, you can use searchcollections to find specific groups of interest.

Q: Can I get all the photos from a specified Unsplash collection with the Google ADK?

Yes. Pass the Collection ID into listcollectionphotos. The tool returns every photo contained within that boundary, making bulk processing easy.

Q: What if I need to track assets uploaded by a specific user on Unsplash with the Google ADK?

First, use searchphotographers to find the correct username. Then, pass that username into getphotographerphotos to pull their full portfolio.

Q: Does the Google ADK help me identify the most current Unsplash photos?

Absolutely. The listlatestphotos tool pulls a list of the most recently uploaded images, ensuring your data pipeline always has access to fresh material.

Integrate Unsplash creative assets into your enterprise pipelines using the Google ADK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unsplash MCP to Google ADK

Create your Vinkius account to connect Unsplash to Google ADK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Unsplash with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Process full photo collections from Unsplash.

Use `get_collection_details` to get metadata for an entire set of photos. This tells you everything about the collection, not just one image. If you have a specific Collection ID, `list_collection_photos` lists every single photo contained within that group. This is crucial when your system needs to process hundreds of assets at once.

Manage and discover the newest Unsplash content.

Your agent can check what's fresh using `list_latest_photos`, giving you immediate access to newly uploaded visual material. This keeps your enterprise data pipeline current. Beyond just new uploads, the tool `list_editorial_topics` helps you track broad trends, like 'Space' or 'Urban Life,' for better content planning.

Deeply inspect metadata and user portfolios from Unsplash.

`get_photo_details` retrieves every possible piece of data on a single photo ID, allowing your agent to run deep background checks on the asset. This is useful for compliance. To map out creator resources, call `search_photographers`. You can then use `get_photographer_photos` to gather all assets associated with one specific user account.

Setup guide

Set up Unsplash MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Unsplash tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Unsplash_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Unsplash tools via MCP.",
    tools=mcp_tools,
)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Unsplash. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Unsplash now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Unsplash MCP in Google ADK

Start by calling `list_editorial_topics` to map out available categories. Then, you can use `search_collections` to find specific groups of interest.

Yes. Pass the Collection ID into `list_collection_photos`. The tool returns every photo contained within that boundary, making bulk processing easy.

First, use `search_photographers` to find the correct username. Then, pass that username into `get_photographer_photos` to pull their full portfolio.

Absolutely. The `list_latest_photos` tool pulls a list of the most recently uploaded images, ensuring your data pipeline always has access to fresh material.

You'll primarily be handling Photo IDs and URLs. These unique strings let your agent retrieve full details or list contents from the server.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python