Twelve Labs (Video Understanding) MCP Server for Mastra AIGive Mastra AI instant access to 18 tools to Analyze Async, Analyze Sync, Confirm Multipart Upload, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Twelve Labs (Video Understanding) 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 Twelve Labs (Video Understanding) MCP Server for Mastra AI is a standout in the Ai Frontier category — giving your AI agent 18 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: {
"twelve-labs-video-understanding": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Twelve Labs (Video Understanding) Agent",
instructions:
"You help users interact with Twelve Labs (Video Understanding) " +
"using 18 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Twelve Labs (Video Understanding)?"
);
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 Twelve Labs (Video Understanding) MCP Server
Connect Twelve Labs to your AI agent to unlock the full potential of video understanding. This server allows your agent to index video files, perform complex semantic searches, and generate deep analytical insights from visual and audio data.
Mastra's agent abstraction provides a clean separation between LLM logic and Twelve Labs (Video Understanding) tool infrastructure. Connect 18 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
- Video Indexing — Create and manage indexes to organize your video library for rapid retrieval and analysis.
- Semantic Search — Query your video content using natural language to find specific moments, objects, or actions without manual tagging.
- Asset Management — Upload videos via URLs or multipart sessions and monitor their indexing status in real-time.
- Deep Analysis — Run synchronous or asynchronous analysis tasks to extract structured data from your video assets.
- Embeddings & Entities — Generate multimodal embeddings and manage entity collections for advanced machine learning workflows.
The Twelve Labs (Video Understanding) MCP Server exposes 18 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 18 Twelve Labs (Video Understanding) tools available for Mastra AI
When Mastra AI connects to Twelve Labs (Video Understanding) through Vinkius, your AI agent gets direct access to every tool listed below — spanning video-search, multimodal-ai, semantic-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.
Analyze async on Twelve Labs (Video Understanding)
Analyze and segment videos asynchronously
Analyze sync on Twelve Labs (Video Understanding)
Analyze and segment videos synchronously
Confirm multipart upload on Twelve Labs (Video Understanding)
Confirm a multipart upload
Create asset on Twelve Labs (Video Understanding)
Upload content to create an asset
Create entity on Twelve Labs (Video Understanding)
g., a person) within a collection. Create an entity
Create entity collection on Twelve Labs (Video Understanding)
Create an entity collection
Create index on Twelve Labs (Video Understanding)
Create a new index
Create multipart upload on Twelve Labs (Video Understanding)
Create a multipart upload session
Delete index on Twelve Labs (Video Understanding)
Delete an index
Embed async on Twelve Labs (Video Understanding)
Create embeddings asynchronously
Embed sync on Twelve Labs (Video Understanding)
Create embeddings synchronously
Get index on Twelve Labs (Video Understanding)
Retrieve an index by ID
Get indexed asset on Twelve Labs (Video Understanding)
Retrieve an indexed asset
Index asset on Twelve Labs (Video Understanding)
Index an uploaded asset
List indexes on Twelve Labs (Video Understanding)
List all indexes
Report multipart progress on Twelve Labs (Video Understanding)
Report progress for a multipart upload
Search on Twelve Labs (Video Understanding)
Search for moments in videos
Update index on Twelve Labs (Video Understanding)
Update an index name
Connect Twelve Labs (Video Understanding) to Mastra AI via MCP
Follow these steps to wire Twelve Labs (Video Understanding) 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 Twelve Labs (Video Understanding) MCP Server
Mastra AI provides unique advantages when paired with Twelve Labs (Video Understanding) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Twelve Labs (Video Understanding) 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 Twelve Labs (Video Understanding) 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
Twelve Labs (Video Understanding) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Twelve Labs (Video Understanding) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Twelve Labs (Video Understanding), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Twelve Labs (Video Understanding) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Twelve Labs (Video Understanding) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Twelve Labs (Video Understanding) tools alongside other MCP servers
Example Prompts for Twelve Labs (Video Understanding) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Twelve Labs (Video Understanding) immediately.
"List all my Twelve Labs video indexes."
"Create a new index named 'Webinar-Archive' using the Marengo 3.0 model with visual and audio options."
"Search for 'a person presenting a slideshow' in index idx_abc123."
Troubleshooting Twelve Labs (Video Understanding) MCP Server with Mastra AI
Common issues when connecting Twelve Labs (Video Understanding) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpTwelve Labs (Video Understanding) + Mastra AI FAQ
Common questions about integrating Twelve Labs (Video Understanding) 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 →
Mailshake
12 toolsRun cold email outreach campaigns with personalization, automated follow-ups, and reply detection that fills your sales pipeline.
Hevo Data (ETL & Data Pipeline)
6 toolsManage data pipelines via Hevo — list pipelines, monitor destinations, and track usage.
Descope (Auth Platform)
33 toolsManage user authentication flows via Descope — initiate OTPs, Magic Links, Enchanted Links, and OAuth directly from your AI agent.
Dot Object Transformer
1 toolsFlatten deeply nested JSON objects into dot-notation keys, or reconstruct nested objects from flat dictionaries.