How to Use the Namely MCP in Vercel AI SDK

Q: How do I connect the Vercel AI SDK to Namely?

You'll use the @ai-sdk/mcp package. Just instantiate createMCPClient with your Vinkius endpoint URL and pass the tools to generateText or streamText. It's a few lines of code to get started.

Q: Can I filter employee profiles with Namely and the Vercel AI SDK?

Yes. The listprofiles tool accepts parameters for filtering by team, group, or other fields. Your agent can pass these arguments to get specific slices of employee data from Namely for your Vercel AI SDK app.

Q: What's the best way to show Namely team data in a Next.js app using the Vercel AI SDK?

Use Server Components to fetch initial data with listteams. Then, use streaming in a Client Component to dynamically fetch and display individual profiles with getprofile as the user interacts with the page.

Build UIs that stream live HR data from Namely directly into your Vercel AI SDK application. No 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 Namely MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Org Charts into React

This tool lets your Vercel AI SDK agent build a dynamic org chart component that populates in real-time. Your agent calls `list_profiles` and `list_teams`, and the data streams directly into your UI. Users see names and teams appearing one by one, not all at once after a long wait. When someone clicks a profile in your app, the agent can call `get_profile` to fetch and display their detailed info. The UI feels alive because the data flows from the MCP server, through your Edge Function, and right into the user's view without a page refresh.

Feed Live Updates to Your Dashboard

You can build a company dashboard that's always current. Your agent uses `list_announcements` and `list_events` to create a live feed of company news, birthdays, and anniversaries. New updates just appear in your React or Svelte components as they're streamed from Namely. It's not a static page. It’s a direct connection to your company's pulse, powered by this MCP server.

Build Dynamic Job Boards with Vercel AI SDK

Let your agent query open positions using the `list_jobs` tool. It can stream job titles and descriptions straight into a component, creating an internal job board that's always up to date. Combine it with `list_groups` to let users filter jobs by department or office. The results update instantly as your AI streams the filtered data back to the client. It’s a fast, interactive way for employees to find their next role.

Setup guide

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

You'll use the `@ai-sdk/mcp` package. Just instantiate `createMCPClient` with your Vinkius endpoint URL and pass the tools to `generateText` or `streamText`. It's a few lines of code to get started.

Yes. The `list_profiles` tool accepts parameters for filtering by team, group, or other fields. Your agent can pass these arguments to get specific slices of employee data from Namely for your Vercel AI SDK app.

Use Server Components to fetch initial data with `list_teams`. Then, use streaming in a Client Component to dynamically fetch and display individual profiles with `get_profile` as the user interacts with the page.

Yes. The Vinkius platform is built for low-latency responses, and the Vercel AI SDK is designed for streaming. The combination means data from tools like `list_announcements` appears in your UI almost instantly.

Your connection is secured through a single Vinkius endpoint token. The MCP Server only touches the specific employee profile data, team structures, and job info you request. All operations run in an ephemeral, zero-trust sandbox that is destroyed after each request.

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