How to Use the Cosmic MCP in Vercel AI SDK

Q: How do I connect the Cosmic MCP Server to Vercel AI SDK?

Install the @ai-sdk/mcp package and initialize the client using the Vinkius HTTP endpoint. Call mcpClient.tools() and pass those tools directly into streamText or generateText.

Q: Does Vercel AI SDK support streaming media checks from Cosmic?

Yes, the agent uses getmediaasset to retrieve structural matches for specific media files. The metadata streams straight to your frontend, letting you render images or documents immediately.

Q: How does Cosmic handle schema validation errors?

Your agent queries the MCP server via listschematypes to learn the rules before sending data. If an error occurs during a createcmsobject call, the server returns the exact error payload so the agent can correct its JSON structure.

Feed live Cosmic CMS data directly into your Vercel AI SDK frontend without loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cosmic MCP to Vercel AI SDK

Create your Vinkius account to connect Cosmic 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 Cosmic with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Mutate Cosmic drafts live via this MCP Server

Updating drafts in real-time uses `patch_cms_object` to stream content changes straight into your React or Next.js UI. Your agent edits live drafts and pushes JSON payloads straight to Cosmic without making the user stare at a loading wheel. This setup runs anywhere, including Edge Functions. You get direct access to write operations, allowing your frontend to render the exact state of your CMS documents as they modify.

Inspect schema properties dynamically

Inspecting your headless CMS structure relies on `get_schema_details` to pull active fields before you write content. Your agent uses this tool to extract properties and validation rules governing your content on the fly. Having this structural awareness prevents runtime errors during live generation. The client adapts its output format to match your Cosmic blueprints perfectly.

Control media assets straight from the client

Managing your file library directly inside the chat window uses `list_uploaded_media` to inspect active assets. Your agent checks deep internal arrays to make sure you stay within your picture limits. This keeps your media library clean so you don't have to dive into a manual dashboard. The Vercel AI SDK handles the file metadata stream, letting users inspect assets instantly.

Setup guide

Set up Cosmic 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 Cosmic 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 Cosmic 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 Cosmic. 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 Cosmic 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 Cosmic MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package and initialize the client using the Vinkius HTTP endpoint. Call `mcpClient.tools()` and pass those tools directly into `streamText` or `generateText`.

Yes, this integration is fully compatible with Edge Functions. Because the client relies on lightweight HTTP transport to talk to the Vinkius sandbox, it avoids heavy Node.js dependencies.

Yes, the agent uses `get_media_asset` to retrieve structural matches for specific media files. The metadata streams straight to your frontend, letting you render images or documents immediately.

Your agent queries the MCP server via `list_schema_types` to learn the rules before sending data. If an error occurs during a `create_cms_object` call, the server returns the exact error payload so the agent can correct its JSON structure.

Your Cosmic drafts, schema details, and media assets never persist outside your direct session. Vinkius runs the Cosmic MCP Server inside an ephemeral, isolated sandbox that destroys itself immediately after your API call finishes, secured by a single endpoint token.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript