How to Use the Wizehire MCP in Mastra AI

Q: If I run a job, how does Mastra AI handle errors with Wizehire?

Mastra AI builds in automatic retries. If getjobdetails fails once, it doesn't quit; it waits and tries again until the data is retrieved successfully.

Q: Can I manage candidate statuses with Wizehire using Mastra AI?

Absolutely. You can use updatecandidatehiringstage to move candidates. If that update fails, your workflow can trigger a human-in-the-loop approval step.

Q: How do I list job openings with Wizehire using Mastra AI?

Simply call listactivejobpostings. The workflow executes this tool, and if the API is slow, Mastra AI manages the wait time until it gets a complete list.

Q: Does Wizehire support webhooks via Mastra AI?

Yes. You can use listconfiguredwebhooks to check what hooks are active. This is useful for building workflows that react when external events happen.

Build resilient hiring workflows with Wizehire and Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wizehire MCP to Mastra AI

Create your Vinkius account to connect Wizehire to Mastra AI 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 Wizehire with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Candidate Pipelines Reliably

When a candidate changes status, use `update_candidate_hiring_stage`. If the process fails (say, the target stage doesn't exist), Mastra AI handles the retry logic or notifies an admin. You don't have to worry about flaky API calls. Need to get initial data? Call `get_job_details` and let Mastra AI manage the retrieval attempts until it gets a solid result.

Automate New Candidate Intake

To manually add candidates, use `create_new_candidate`. If this fails due to bad data, your workflow can automatically trigger an email notification and pause execution. It's built for failure handling. If you need a list of people, `list_candidates` pulls the full roster, making it ideal for complex reporting workflows that require multiple attempts.

Check Wizehire Statuses in Workflows

Start any workflow by calling `check_api_health`. Mastra AI ensures this check happens before running critical steps. It's a reliable gatekeeper for your overall process. You can also list available resources—like office locations using `list_office_locations` or hiring teams with `list_hiring_team`—and the workflow will retry fetching that data if the first attempt times out.

Setup guide

Set up Wizehire MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Wizehire tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "wizehire-mcp-client",
  servers: {
    "wizehire-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Wizehire Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Wizehire tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Wizehire transactions"
);
console.log(result.text);

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 Wizehire. 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 Wizehire 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 Wizehire MCP in Mastra AI

Mastra AI builds in automatic retries. If `get_job_details` fails once, it doesn't quit; it waits and tries again until the data is retrieved successfully.

Absolutely. You can use `update_candidate_hiring_stage` to move candidates. If that update fails, your workflow can trigger a human-in-the-loop approval step.

It handles candidate personal information (names, emails), job postings details, and defined organizational resources like locations and teams.

Simply call `list_active_job_postings`. The workflow executes this tool, and if the API is slow, Mastra AI manages the wait time until it gets a complete list.

Yes. You can use `list_configured_webhooks` to check what hooks are active. This is useful for building workflows that react when external events happen.

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