How to Use the Unsplash Extended MCP in Mastra AI

Q: How does Unsplash Extended support tracking downloads with Mastra AI?

You incorporate the trackphotodownload tool into your workflow. Because of its reliability, you can ensure that attribution is recorded even if other steps in a long process fail.

Q: What is the best way to search photos with Unsplash Extended and Mastra AI?

Use searchphotos as the first step. If the keyword yields no results, your workflow can branch and execute a fallback action like fetching random photos using getrandomphoto. This makes for resilient code.

Build complex photo workflows with Mastra AI and Unsplash Extended.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unsplash Extended MCP to Mastra AI

Create your Vinkius account to connect Unsplash Extended to Mastra AI 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 Extended with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Complex MCP Server Workflows

The `unsplash-extended-mcp` server supports multi-step logic. You can build a workflow that first calls `get_random_photo`, then checks its statistics using `get_photo_statistics`. If the stats are low, it retries by calling `list_photos` instead. Mastra AI handles this failure gracefully. It automatically retries the photo search or collection management call with exponential backoff, so your complex operation doesn't just crash.

Handling User Authentication Steps

You can design a workflow that requires human approval before changing data. For instance, an agent might fetch a user profile using `get_me`, and if the change is critical, it pauses for your required tool approval. Once approved, Mastra AI executes the necessary write operation—maybe running `update_collection` or calling `add_photo_to_collection`.

Advanced Photo Search and Retrieval

Building a complex search? Your workflow can run through multiple steps: first, call `search_collections` with a keyword. Second, use the resulting IDs to call `get_collection_photos`. This sequential process is perfect for Mastra AI's built-in conditional branching. This allows you to build highly specific photo discovery pipelines that adapt based on what initial searches return.

Setup guide

Set up Unsplash Extended MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Unsplash Extended tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "unsplash-extended-mcp-client",
  servers: {
    "unsplash-extended-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Unsplash Extended Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Unsplash Extended tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Unsplash Extended transactions"
);
console.log(result.text);

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 Extended 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 Extended MCP in Mastra AI

You define a sequence of tools in your workflow. For example, you can run `get_topic` followed by `get_topic_photos`. If the first call succeeds, Mastra AI automatically passes the ID to the second tool.

Yes. You can build a workflow that lists all public collections with `list_collections`, identifies the target, and then uses `update_collection` to modify it. This whole process is handled as one reliable, multi-step task.

You incorporate the `track_photo_download` tool into your workflow. Because of its reliability, you can ensure that attribution is recorded even if other steps in a long process fail.

Use `search_photos` as the first step. If the keyword yields no results, your workflow can branch and execute a fallback action like fetching random photos using `get_random_photo`. This makes for resilient code.

This server touches Photo Metadata, User Profile, and Collection Data. When designing your workflow, ensure that sensitive state changes like `update_me` are managed through the controlled tool approval step.

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

Vercel AI SDK sdk-typescript