How to Use the HireVue MCP in Vercel AI SDK

Q: Can I use Vercel AI SDK to cancel HireVue interviews?

Yes. You can call the cancelinterview tool directly within your Vercel AI SDK streamText tool calls. Your Vercel AI SDK frontend will reflect the HireVue cancellation immediately as the tool execution completes.

Q: Is it possible to update candidate data with Vercel AI SDK?

Yes, you can use the updatecandidate tool to modify HireVue candidate records based on Vercel AI SDK chat inputs. Your AI agent handles the parameters and sends the updates to HireVue through the secure Vinkius connection.

Stream HireVue interview invitations and candidate updates directly into your React UI with the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HireVue MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream HireVue Statuses Live with Vercel AI SDK

The `get_interview` tool lets your Vercel AI SDK application fetch live HireVue interview statuses and stream the progress directly to your Next.js dashboard. Instead of waiting for a full HireVue API response, your users see the status update in real-time as the Vercel AI SDK agent fetches the data. You can pair this with `get_candidate` to show HireVue candidate profiles side-by-side with their interview progression in your React frontend. This setup eliminates loading spinners, letting hiring managers view live HireVue applicant statuses instantly on the edge using Vercel AI SDK.

Instant HireVue Candidate Creation on the Edge

The `create_candidate` tool registers new applicant profiles directly from your Vercel AI SDK chat interface into HireVue. Your custom recruitment app can take a resume upload, parse the details, and trigger this tool to populate your HireVue dashboard in real-time. By using `update_candidate` alongside it, recruiters using your Vercel AI SDK interface can modify applicant details on the fly. Because Vercel AI SDK runs on Edge Functions, these HireVue updates render instantly without server-side lag.

Manage Positions via MCP Server Tools

The `list_positions` tool retrieves active job openings so your Vercel AI SDK UI can display current HireVue roles to applicants. This allows your custom Vercel AI SDK chatbot to match candidates to open roles and pull details using `get_position` instantly. Once a match is found, the Vercel AI SDK agent can call `create_interview` to schedule the HireVue session. This entire interaction streams directly into the React chat window using the hosted MCP connection.

Setup guide

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

You should implement standard exponential backoff in your Next.js API routes when calling HireVue tools. Since Vinkius hosts the MCP Server on a V8 sandbox, connection overhead is minimal, but you must respect HireVue API limits when calling `create_interview` in rapid succession from your Vercel AI SDK application.

Yes. You can call the `cancel_interview` tool directly within your Vercel AI SDK `streamText` tool calls. Your Vercel AI SDK frontend will reflect the HireVue cancellation immediately as the tool execution completes.

Vinkius handles the underlying authentication tokens securely. Your Vercel AI SDK application only needs to provide one endpoint token to connect to the hosted MCP Server, keeping your HireVue API credentials hidden from the client side.

Yes, you can use the `update_candidate` tool to modify HireVue candidate records based on Vercel AI SDK chat inputs. Your AI agent handles the parameters and sends the updates to HireVue through the secure Vinkius connection.

All HireVue candidate profiles and interview statuses are processed within Vinkius's zero-trust V8 isolate sandbox. Your Vercel AI SDK edge functions communicate over secure, ephemeral channels, ensuring no applicant data is cached or stored permanently on the server.

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