How to Use the Nuclino MCP in Vercel AI SDK

Q: Can my Vercel AI SDK interface perform a Nuclino search?

Yes, pass searchitems to your agent tools. It executes a semantic search across your team to find relevant document UUIDs.

Build live knowledge interfaces in your Next.js apps by connecting the Nuclino MCP Server to your Vercel AI SDK project.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuclino MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time document streaming in Vercel AI SDK

Feed your UI live documentation directly from your knowledge base. When your app calls `list_items`, the data flows through the SDK to populate your components without waiting for background syncs. Your users see the content update as the agent pulls it. Use `get_item` to fetch specific Markdown payloads for immediate rendering in your frontend.

Managing Nuclino content with AI client tools

You can push new edits or create pages from your web app. Trigger `create_item` to save user input as permanent wiki documentation. Use `update_item` to sync state changes back to your workspace. This setup keeps your application data and your team documentation in perfect lockstep.

Organizing workspace navigation

Map your application structure to your wiki directories. Start by calling `list_workspaces` to identify where your project data lives. Use `list_collections` to trace document paths. This allows your Vercel AI SDK interface to mirror the hierarchy of your existing team knowledge.

Setup guide

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

Install the MCP client packages and point your transport to the Vinkius endpoint. Define your tools using the SDK's tool registry to give your agent access to workspace operations.

Yes, pass `search_items` to your agent tools. It executes a semantic search across your team to find relevant document UUIDs.

It does. Because the server supports streaming, you can pipe tool results directly into your generative UI components as they arrive.

Vinkius manages the handshake. You provide your endpoint token during the client initialization, which handles the session for all subsequent requests.

Data access is strictly scoped to your authorized account. The MCP server only processes the specific item content or metadata requested by your agent during a live session.

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