PhotoPrism MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 7 tools to Create Oauth Token, Get Oauth Authorize, Get Oauth Userinfo, and more
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect PhotoPrism through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this MCP Server for Vercel AI SDK
The PhotoPrism MCP Server for Vercel AI SDK is a standout in the Productivity category — giving your AI agent 7 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using PhotoPrism, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
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 PhotoPrism MCP Server
Connect your self-hosted PhotoPrism instance to any AI agent to interact with your personal media collection through natural language.
The Vercel AI SDK gives every PhotoPrism tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 7 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
What you can do
- Advanced Search — Query your library using keywords, colors, or dates with the
search_photostool. - 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_tokenandget_oauth_userinfo.
The PhotoPrism MCP Server exposes 7 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 7 PhotoPrism tools available for Vercel AI SDK
When Vercel AI SDK connects to PhotoPrism through Vinkius, your AI agent gets direct access to every tool listed below — spanning media-management, photo-library, metadata-search, 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.
Create oauth token on PhotoPrism
Create an OAuth2 token
Get oauth authorize on PhotoPrism
Get OAuth2 Authorization
Get oauth userinfo on PhotoPrism
Get OAuth2 UserInfo
Get thumbnail url on PhotoPrism
Get a thumbnail image URL for a photo
Get video url on PhotoPrism
Get a video streaming URL
Revoke oauth token on PhotoPrism
Revoke an OAuth2 token
Search photos on PhotoPrism
Search for photos in PhotoPrism
Connect PhotoPrism to Vercel AI SDK via MCP
Follow these steps to wire PhotoPrism into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the PhotoPrism MCP Server
Vercel AI SDK provides unique advantages when paired with PhotoPrism through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same PhotoPrism integration everywhere
Built-in streaming UI primitives let you display PhotoPrism tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
PhotoPrism + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the PhotoPrism MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query PhotoPrism in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate PhotoPrism tools and return structured JSON responses to any frontend
Chatbots with tool use: embed PhotoPrism capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with PhotoPrism through natural language queries
Example Prompts for PhotoPrism in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with PhotoPrism immediately.
"Search for photos of 'mountains' taken in 2023."
"Get a high-resolution thumbnail for the photo with hash 7af8b9c0."
"Show me my PhotoPrism account information."
Troubleshooting PhotoPrism MCP Server with Vercel AI SDK
Common issues when connecting PhotoPrism to Vercel AI SDK through Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpPhotoPrism + Vercel AI SDK FAQ
Common questions about integrating PhotoPrism MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Explore More MCP Servers
View all →
Missive
10 toolsCollaborative email and shared inbox for teams.

UUID Generator Engine
1 toolsGenerate enterprise-grade UUIDs v4, v5, and v7 conforming to RFC 9562. The standard that banks, healthcare, and Fortune 500 trust. 80M+ weekly downloads.

100ms
9 toolsManage video rooms, active sessions, and participants on 100ms — the powerful live video infrastructure.

Bonusly
10 toolsRecognize and reward your team via Bonusly — give bonuses, track points, and view leaderboards directly from any AI agent.
