Unsplash Extended MCP Server for Mastra AIGive Mastra AI instant access to 28 tools to Add Photo To Collection, Create Collection, Delete Collection, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Unsplash Extended through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Unsplash Extended MCP Server for Mastra AI is a standout in the Design Creative category — giving your AI agent 28 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"unsplash-extended": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Unsplash Extended Agent",
instructions:
"You help users interact with Unsplash Extended " +
"using 28 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Unsplash Extended?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Unsplash Extended MCP Server
Connect your Unsplash developer account to any AI agent and integrate the world's most popular open image library into your creative workflows.
Mastra's agent abstraction provides a clean separation between LLM logic and Unsplash Extended tool infrastructure. Connect 28 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Photo Discovery — Search for specific imagery, list editorial feeds, or fetch random photos filtered by orientation, topics, or collections.
- Collection Management — Create, update, and organize photo collections. Add or remove images to curate your visual assets.
- User Insights — Retrieve public profiles, list user-specific uploads, and analyze engagement through detailed statistics.
- Engagement — Like or unlike photos and track downloads to comply with Unsplash API guidelines.
- Topic Exploration — Browse curated topics and fetch high-quality photos categorized by the Unsplash editorial team.
The Unsplash Extended MCP Server exposes 28 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 28 Unsplash Extended tools available for Mastra AI
When Mastra AI connects to Unsplash Extended through Vinkius, your AI agent gets direct access to every tool listed below — spanning stock-photography, image-search, visual-assets, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add photo to collection on Unsplash Extended
Add a photo to a collection (requires user auth)
Create collection on Unsplash Extended
Create a new collection (requires user auth)
Delete collection on Unsplash Extended
Delete a collection (requires user auth)
Get collection on Unsplash Extended
Get a single collection by ID
Get collection photos on Unsplash Extended
Get photos in a specific collection
Get me on Unsplash Extended
Get the authenticated user profile
Get photo on Unsplash Extended
Get a single photo by ID
Get photo statistics on Unsplash Extended
Get statistics for a specific photo
Get random photo on Unsplash Extended
Get one or more random photos
Get related collections on Unsplash Extended
List related collections for a given collection ID
Get topic on Unsplash Extended
Get a single topic by ID or slug
Get topic photos on Unsplash Extended
Get photos for a specific topic
Get user on Unsplash Extended
Get a user public profile
Get user statistics on Unsplash Extended
Get user download and view statistics
Like photo on Unsplash Extended
Like a photo on behalf of the authenticated user
List collections on Unsplash Extended
List all public collections
List photos on Unsplash Extended
List photos from the editorial feed
List topics on Unsplash Extended
List all topics
List user collections on Unsplash Extended
List collections created by a user
List user photos on Unsplash Extended
List photos uploaded by a user
Remove photo from collection on Unsplash Extended
Remove a photo from a collection (requires user auth)
Search collections on Unsplash Extended
Search collections by keyword
Search photos on Unsplash Extended
Search photos by keyword
Search users on Unsplash Extended
Search users by keyword
Track photo download on Unsplash Extended
Track a photo download (Required for attribution)
Unlike photo on Unsplash Extended
Remove a like from a photo on behalf of the authenticated user
Update collection on Unsplash Extended
Update an existing collection (requires user auth)
Update me on Unsplash Extended
Update the authenticated user profile
Connect Unsplash Extended to Mastra AI via MCP
Follow these steps to wire Unsplash Extended into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Unsplash Extended MCP Server
Mastra AI provides unique advantages when paired with Unsplash Extended through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Unsplash Extended without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Unsplash Extended tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Unsplash Extended + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Unsplash Extended MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Unsplash Extended, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Unsplash Extended as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Unsplash Extended on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Unsplash Extended tools alongside other MCP servers
Example Prompts for Unsplash Extended in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Unsplash Extended immediately.
"Search for 3 high-resolution photos of 'minimalist workspace' in landscape orientation."
"Get a random photo from the 'Architecture' topic."
"Show me the statistics for the user 'unsplash_photographer'."
Troubleshooting Unsplash Extended MCP Server with Mastra AI
Common issues when connecting Unsplash Extended to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpUnsplash Extended + Mastra AI FAQ
Common questions about integrating Unsplash Extended MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Kolide
10 toolsAudit fleet security — list devices, track issues, and monitor people.
OpnForm
11 toolsCreate beautiful open-source forms with conditional logic, file uploads, and integrations that rival premium form builders.
Thesaurus API
2 toolsSearch synonyms and antonyms — audit linguistics via AI.
BlogIn
7 toolsKeep your team informed with internal blog posts, company updates, and knowledge sharing that everyone actually reads.