4,000+ servers built on vurb.ts
Vinkius
PhotoPrism

PhotoPrism MCP Server with 7 Tools for Claude, Cursor, and AI Agents

MCP Inspector GDPR Free for Subscribers

Search, browse, and manage your PhotoPrism media library — find photos by metadata, retrieve thumbnails, and stream videos via AI. Vinkius routes your AI agents directly to PhotoPrism through a governed connection. 7 tools ready to use with Claude, ChatGPT, Cursor, or any AI agent — no hosting, no setup, connect in 30 seconds.

Built for AI Agents by Vinkius

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
AI AgentVinkius
High Security·Kill Switch·Plug and Play
PhotoPrism
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

What is the PhotoPrism MCP Server?

The PhotoPrism MCP Server routes AI agents like Claude, ChatGPT, and Cursor directly to PhotoPrism via 7 tools. Search, browse, and manage your PhotoPrism media library — find photos by metadata, retrieve thumbnails, and stream videos via AI. Powered by Vinkius — your credentials stay on your side of the connection, every request is auditable. Connect in under 2 minutes.

Built-in capabilities (7)

create_oauth_tokenget_oauth_authorizeget_oauth_userinfoget_thumbnail_urlget_video_urlrevoke_oauth_tokensearch_photos

Tools for your AI Agents to operate PhotoPrism

Ask your AI agent "Search for photos of 'mountains' taken in 2023." and get the answer without opening a single dashboard. With 7 tools connected to real PhotoPrism data, your agents reason over live information, cross-reference it with other MCP servers, and deliver insights you would spend hours assembling manually.

Works with Claude, ChatGPT, Cursor, and any MCP-compatible client. Powered by Vinkius — your credentials never touch the AI model, every request is auditable. Connect in under two minutes.

Why teams choose Vinkius

One subscription gives you the infrastructure to connect your AI agents to thousands of MCP servers — and deploy your own to the Vinkius Edge. Your credentials stay yours. Your data flows directly between your agent and the API. DLP blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade routing and governance, zero maintenance.

Build your own MCP Server with our secure development framework →

The PhotoPrism App Connector works with every AI agent you already use

…and any MCP-compatible client

CursorClaudeOpenAIVS CodeCopilotGoogleLovableMistralAWSCursorClaudeOpenAIVS CodeCopilotGoogleLovableMistralAWS

Use all 7 PhotoPrism tools with your AI agents right now

Vinkius routes your AI agents to PhotoPrism through a governed proxy. Beyond a simple connection, you get full visibility into every action your agents perform, with enterprise-grade security and up to 60% savings on AI costs.

Explore Tools Hub
create

Create oauth token on PhotoPrism

Create an OAuth2 token

get

Get oauth authorize on PhotoPrism

Get OAuth2 Authorization

get

Get oauth userinfo on PhotoPrism

Get OAuth2 UserInfo

get

Get thumbnail url on PhotoPrism

Get a thumbnail image URL for a photo

get

Get video url on PhotoPrism

Get a video streaming URL

revoke

Revoke oauth token on PhotoPrism

Revoke an OAuth2 token

search

Search photos on PhotoPrism

Search for photos in PhotoPrism

What the PhotoPrism MCP Server unlocks

Connect your self-hosted PhotoPrism instance to any AI agent to interact with your personal media collection through natural language.

What you can do

  • Advanced Search — Query your library using keywords, colors, or dates with the search_photos tool.
  • Visual Previews — Generate direct URLs for thumbnails in various sizes using get_thumbnail_url.
  • Video Streaming — Access streaming links for your stored videos with get_video_url.
  • OAuth Management — Handle authentication tokens and user information securely with create_oauth_token and get_oauth_userinfo.

How it works

1. Subscribe to this server
2. Enter your PhotoPrism URL and API Token
3. Start searching and viewing your media from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Photography Enthusiasts — Quickly find specific shots without manual scrolling through thousands of files
  • Self-Hosters — Integrate your private cloud with your favorite AI tools for a seamless media experience
  • Content Creators — Retrieve assets from your library directly within your coding or writing workflow

Frequently asked questions about the PhotoPrism MCP Server

Can I search for photos by specific filters like color or camera model?

Yes! Use the search_photos tool with the q parameter. You can use filters like 'color:blue' or 'camera:iPhone' just as you would in the PhotoPrism web interface.

What thumbnail sizes are available for my photos?

The get_thumbnail_url tool supports several standard sizes: tile_50, tile_500, fit_720, fit_1280, and fit_1920.

Does this integration support video playback?

Yes. The get_video_url tool constructs a streaming URL for a specific file hash, allowing you to view your videos directly from the provided link.

Vinkius AI Gateway

We built the connector to PhotoPrism. Now put your agents to work. Fully governed.

Vinkius is the AI Gateway with managed hosting. Stop building connectors. Every connection runs inside eight layers of security.

How it works
Infrastructure

Hosted, sandboxed, and live on AWS. You don't provision anything. You don't maintain anything. You connect.

Visibility

Every tool call, every token, every response. Logged and auditable. Data flows direct from PhotoPrism to your agent. Nothing is stored on our side. Ever.

Control

Eight governance layers on every request. Sensitive data redacted before it reaches the model. Kill switch if anything goes sideways. Always on.