How to Use the Colossyan MCP in Vercel AI SDK

Colossyan MCP Server lets your Vercel AI SDK frontends generate and stream video assets directly to your users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Colossyan MCP to Vercel AI SDK

Create your Vinkius account to connect Colossyan to Vercel AI SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Colossyan with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate video assets in Vercel AI SDK

Trigger `generate_video` or `generate_from_template` calls inside your Edge Functions. The SDK handles the heavy lifting, pushing results into your UI state the moment they arrive. Your users watch the rendering happen without staring at empty loading spinners. It turns your interface into a live media production studio.

Manage your Colossyan media assets

Use `list_actors` and `list_voices` to populate dropdowns or selectors in your React components. You get direct access to the workspace library without building custom API wrappers. Keep your project clean by calling `delete_video` or `delete_job` when a session finishes. You control the lifecycle of every asset from your frontend code.

Track rendering status in real-time

Poll `get_job_status` to update progress bars in your Next.js dashboard. You know exactly when a file is ready for the user to download. Everything flows back through the Vercel AI SDK pipes. It’s the fastest way to get generated video into a production-ready application.

Setup guide

Set up Colossyan MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Colossyan tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Colossyan transactions",
});

console.log(text);
await mcpClient.close();

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Colossyan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Colossyan now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Colossyan MCP in Vercel AI SDK

Install the MCP client packages and point the transport to your Vinkius endpoint. Use the generateText function to pass tool definitions into your agent context.

Yes, but you should use the job status tools to track completion. Since the SDK is async, your app stays responsive while the server works in the background.

Your API keys and workspace data remain isolated within the Vinkius sandbox. Only your authenticated agents access these video generation tools.

The server returns an error status that you can catch in your SDK call. You then decide whether to retry or alert the user.

Not necessarily. You can call the retrieval tools to fetch metadata on demand directly from the Colossyan API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python