4,000+ servers built on vurb.ts
Vinkius

Unsplash Extended MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 28 tools to Add Photo To Collection, Create Collection, Delete Collection, and more

MCP Inspector GDPR Free for Subscribers

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Unsplash Extended through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Ask AI about this MCP Server for OpenAI Agents SDK

The Unsplash Extended MCP Server for OpenAI Agents SDK is a standout in the Design Creative category — giving your AI agent 28 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
python
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Unsplash Extended Assistant",
            instructions=(
                "You help users interact with Unsplash Extended. "
                "You have access to 28 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Unsplash Extended"
        )
        print(result.final_output)

asyncio.run(main())
Unsplash Extended
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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.

The OpenAI Agents SDK auto-discovers all 28 tools from Unsplash Extended through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Unsplash Extended, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

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 OpenAI Agents SDK 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 OpenAI Agents SDK

When OpenAI Agents SDK 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

Add photo to collection on Unsplash Extended

Add a photo to a collection (requires user auth)

create

Create collection on Unsplash Extended

Create a new collection (requires user auth)

delete

Delete collection on Unsplash Extended

Delete a collection (requires user auth)

get

Get collection on Unsplash Extended

Get a single collection by ID

get

Get collection photos on Unsplash Extended

Get photos in a specific collection

get

Get me on Unsplash Extended

Get the authenticated user profile

get

Get photo on Unsplash Extended

Get a single photo by ID

get

Get photo statistics on Unsplash Extended

Get statistics for a specific photo

get

Get random photo on Unsplash Extended

Get one or more random photos

get

Get related collections on Unsplash Extended

List related collections for a given collection ID

get

Get topic on Unsplash Extended

Get a single topic by ID or slug

get

Get topic photos on Unsplash Extended

Get photos for a specific topic

get

Get user on Unsplash Extended

Get a user public profile

get

Get user statistics on Unsplash Extended

Get user download and view statistics

like

Like photo on Unsplash Extended

Like a photo on behalf of the authenticated user

list

List collections on Unsplash Extended

List all public collections

list

List photos on Unsplash Extended

List photos from the editorial feed

list

List topics on Unsplash Extended

List all topics

list

List user collections on Unsplash Extended

List collections created by a user

list

List user photos on Unsplash Extended

List photos uploaded by a user

remove

Remove photo from collection on Unsplash Extended

Remove a photo from a collection (requires user auth)

search

Search collections on Unsplash Extended

Search collections by keyword

search

Search photos on Unsplash Extended

Search photos by keyword

search

Search users on Unsplash Extended

Search users by keyword

track

Track photo download on Unsplash Extended

Track a photo download (Required for attribution)

unlike

Unlike photo on Unsplash Extended

Remove a like from a photo on behalf of the authenticated user

update

Update collection on Unsplash Extended

Update an existing collection (requires user auth)

update

Update me on Unsplash Extended

Update the authenticated user profile

Connect Unsplash Extended to OpenAI Agents SDK via MCP

Follow these steps to wire Unsplash Extended into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Install the SDK

Run pip install openai-agents in your Python environment
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com
03

Run the script

Save the code above and run it: python agent.py
04

Explore tools

The agent will automatically discover 28 tools from Unsplash Extended

Why Use OpenAI Agents SDK with the Unsplash Extended MCP Server

OpenAI Agents SDK provides unique advantages when paired with Unsplash Extended through the Model Context Protocol.

01

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

02

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

03

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

04

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Unsplash Extended + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Unsplash Extended MCP Server delivers measurable value.

01

Automated workflows: build agents that query Unsplash Extended, process the data, and trigger follow-up actions autonomously

02

Multi-agent orchestration: create specialist agents. one queries Unsplash Extended, another analyzes results, a third generates reports

03

Data enrichment pipelines: stream data through Unsplash Extended tools and transform it with OpenAI models in a single async loop

04

Customer support bots: agents query Unsplash Extended to resolve tickets, look up records, and update statuses without human intervention

Example Prompts for Unsplash Extended in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Unsplash Extended immediately.

01

"Search for 3 high-resolution photos of 'minimalist workspace' in landscape orientation."

02

"Get a random photo from the 'Architecture' topic."

03

"Show me the statistics for the user 'unsplash_photographer'."

Troubleshooting Unsplash Extended MCP Server with OpenAI Agents SDK

Common issues when connecting Unsplash Extended to OpenAI Agents SDK through Vinkius, and how to resolve them.

01

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents
02

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Unsplash Extended + OpenAI Agents SDK FAQ

Common questions about integrating Unsplash Extended MCP Server with OpenAI Agents SDK.

01

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
02

Can I use multiple MCP servers in one agent?

Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
03

Does the SDK support streaming responses?

Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.

Explore More MCP Servers

View all →