How to Use the Gem MCP in Mastra AI

Q: How do I initialize the Gem MCP server in Mastra AI?

Install @mastra/mcp@latest. Create a new MCPClient with your server URL, call mcpClient.listTools(), and spread those into your Agent's tool array.

Q: How do I filter which Gem tools Mastra AI can use?

You don't have to expose everything. Call mcpClient.listTools(), filter the array for specific operations, and only pass those to your agent.

Q: Can I trigger Mastra AI workflows from Gem project changes?

You can poll listtalentprojects on a cron schedule. When the agent detects a new project, it kicks off a sourcing workflow automatically.

Build resilient recruiting workflows by connecting Mastra AI to the Gem MCP Server. Handle rate limits and sync failures automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gem MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient Candidate Syncing

APIs fail. That is just reality. When you push data via `create_crm_candidate`, Mastra handles the network hiccups. If the Gem endpoint drops the connection, the framework catches it. You get automatic retries with exponential backoff. Your workflow attempts `update_crm_candidate` again without you writing custom retry logic. The candidate record syncs eventually, every single time.

Mastra AI Conditional Workflows

Recruiting pipelines require logic, not just blind data dumps. Your agent pulls `list_outreach_sequences` to check active campaigns. If a sequence is full, it branches to a different action. You can route candidates based on team data. The agent checks `list_crm_custom_fields`. If the candidate is an executive, it alerts a human. Junior candidates get added to the standard queue automatically.

Human-in-the-Loop Recruiting

You probably do not want AI blasting emails without oversight. Before the agent executes `add_candidate_note`, Mastra pauses the workflow. A recruiter reviews the draft. You enforce this by setting `requireToolApproval` on the MCP Server connection. The agent prepares the CRM update, but nothing hits the database until your sourcing lead clicks approve.

Setup guide

Set up Gem 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 Gem 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: "gem-mcp-client",
  servers: {
    "gem-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Gem 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 Gem. 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 Gem 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 Gem MCP in Mastra AI

Install `@mastra/mcp@latest`. Create a new `MCPClient` with your server URL, call `mcpClient.listTools()`, and spread those into your Agent's tool array.

Yes. Mastra's built-in workflow engine automatically handles failures when calling tools like `update_crm_candidate`. You configure the retry limits.

You don't have to expose everything. Call `mcpClient.listTools()`, filter the array for specific operations, and only pass those to your agent.

You can poll `list_talent_projects` on a cron schedule. When the agent detects a new project, it kicks off a sourcing workflow automatically.

Candidate interaction logs stay protected. Vinkius runs this tool inside a V8 Isolate Sandbox, ensuring memory drops the second your workflow completes its execution.

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