How to Use the Unsplash Alternative MCP in Mastra AI

Q: How does Mastra AI handle searching for Unsplash Alternative collections?

You call searchcollections within your workflow. If the initial search fails, Mastra AI can automatically attempt a different query or wait and retry it later using its built-in backoff logic.

Q: If I use Unsplash Alternative with Mastra AI, how do I get photo statistics?

Use getphotostats as an explicit step in your workflow. This function call is critical for validation; if the stats aren't available, you can trigger a different branch of logic to notify an admin.

Q: Does Unsplash Alternative support user data retrieval when used with Mastra AI?

Yes. You can use getuser or searchusers. If the user ID is invalid, Mastra AI won't just fail; it will flag the error and wait for human approval before continuing.

Q: Can I list available topics for Unsplash Alternative using Mastra AI?

The listtopics tool provides a structured way to get all curated topic names. This data can feed into an internal validation check, ensuring your workflow only uses known categories.

Build reliable workflows that fetch Unsplash Alternative data with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unsplash Alternative MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Retrieve photo details for complex workflows.

The `get_photo` tool gets detailed information about a specific image. This is useful when you need to check if an asset meets certain criteria before proceeding with a workflow, like needing the source link or description. Mastra AI excels at handling these multi-step needs. If getting photo data fails, your workflow engine can automatically retry the call later or switch to checking `get_photo_stats` instead.

Search for users and check their history.

Need to vet an asset creator? Use `search_users` to find potential contributors, then use `get_user_photos` to see everything they've uploaded. This provides a clear audit trail of the content source. Mastra AI lets you chain these calls together. For example, if your initial search fails due to rate limiting, the built-in exponential backoff retries the entire sequence automatically.

Get random assets as part of a bigger process.

Sometimes a workflow just needs filler content. The `get_random_photo` tool provides an immediate asset and its basic stats. This is perfect for generating placeholder campaigns. Mastra AI manages this gracefully. Your overall job (the campaign generation) can continue even if the random photo retrieval needs multiple attempts, ensuring your final output isn't blocked by a transient network error.

Setup guide

Set up Unsplash Alternative 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 Alternative 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-alternative-mcp-client",
  servers: {
    "unsplash-alternative-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Unsplash Alternative 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 Alternative 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 Alternative MCP in Mastra AI

You call `search_collections` within your workflow. If the initial search fails, Mastra AI can automatically attempt a different query or wait and retry it later using its built-in backoff logic.

Use `get_photo_stats` as an explicit step in your workflow. This function call is critical for validation; if the stats aren't available, you can trigger a different branch of logic to notify an admin.

Yes. You can use `get_user` or `search_users`. If the user ID is invalid, Mastra AI won't just fail; it will flag the error and wait for human approval before continuing.

This server deals with public image metadata, including user uploads, collection details, and asset statistics. It operates entirely on public discovery information; no private credentials are involved.

The `list_topics` tool provides a structured way to get all curated topic names. This data can feed into an internal validation check, ensuring your workflow only uses known categories.

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