How to Use the Capsulink MCP in Vercel AI SDK

Q: How do I handle Capsulink link creation inside a streaming ai-sdk chat?

You register the shortenurl tool in your streamText call. The SDK streams the tool execution status, allowing the shortened link to render in the UI the millisecond Capsulink returns it.

Q: Can I use ai-sdk to change destinations with Capsulink?

Yes, by passing editlinkdestination to the tool array in your SDK configuration. Your agent can take a user's prompt and update the target URL programmatically during a live session.

Q: What is the cleanest way to display Capsulink click stats in ai-sdk?

Use getlinkdailystats within your tool definitions. Let the SDK stream the daily click array directly to your client-side chart components for live rendering.

Let your Vercel AI SDK app shorten URLs and stream click analytics straight to your users in real time.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Capsulink MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant URL Shortening in AI SDK Streams

The `shorten_url` tool lets your AI SDK app generate short links on the fly without making users wait for a full page reload. When a user drops a long link into your chat interface, the agent catches it, hits the Capsulink API, and renders the clean URL immediately. Because Vercel's SDK handles streaming tool calls from this MCP Server natively, the shortened link appears in the UI while the rest of the response is still generating. You don't have to build custom loading spinners or poll an external API.

Live Analytics Boards via Vercel AI SDK

The `get_link_daily_stats` tool pulls real-time click breakdowns directly into your streaming React or Next.js components. Your agent can fetch daily trends and pipe the raw numbers straight to a charting library on the frontend. By combining this with `get_link_stats`, you can show total click volume alongside daily spikes. The user sees their marketing data update live as the agent processes the request.

Dynamic Link Redirection and Management

The `edit_link_destination` tool gives your AI client the power to swap out the target URL of any active short link instantly. If a user points out a broken link in your UI, the agent fixes it on the spot without manual database updates. This MCP Server also exposes `delete_link` to purge dead URLs from your account. It keeps your link dashboard clean without leaving the chat interface.

Setup guide

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

You register the `shorten_url` tool in your `streamText` call. The SDK streams the tool execution status, allowing the shortened link to render in the UI the millisecond Capsulink returns it.

Yes, by passing `edit_link_destination` to the tool array in your SDK configuration. Your agent can take a user's prompt and update the target URL programmatically during a live session.

Use `get_link_daily_stats` within your tool definitions. Let the SDK stream the daily click array directly to your client-side chart components for live rendering.

Vinkius handles the underlying API tokens for you. You only need to pass your single Vinkius endpoint token when initializing the MCP client in your code.

All target URLs and redirect metrics are isolated within Vinkius's secure sandbox environment. No third-party servers ever intercept your raw click data or link directories.

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