How to Use the Gem MCP in Cursor

Build custom recruiting scripts inside Cursor using live candidate data from Gem.

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 Cursor

Create your Vinkius account to connect Gem to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Gem Candidates in Cursor

This MCP Server connects your code editor straight to your recruiting database using `list_candidates` and `get_candidate_details`. You tell Cursor to write a script that processes applicants, and the agent fetches real engineering candidates to test the logic. You never have to mock user profiles again. When you build an internal dashboard, the AI pulls actual names, emails, and LinkedIn URLs. It writes the exact API parsing logic you need based on the actual JSON structure returned by the system.

Write Scripts to Update CRM

Writing automation requires testing write actions, which is why this MCP tool includes `create_crm_candidate` and `update_crm_candidate`. Cursor generates the exact TypeScript interfaces required to push new leads into your pipeline. If your script fails, you run `verify_api_connection` right from the editor chat. The agent diagnoses authentication issues instantly. You fix the headers and run the script again without leaving your IDE.

Map Internal Talent Projects

Developers building internal HR tools need context on how recruiters work, so the agent uses `list_talent_projects` and `get_project_details`. Cursor reads the folder structures your sourcing team actually uses. The AI can also map out your internal team structure with `list_recruiting_team` and check active email campaigns via MCP tools like `list_outreach_sequences`. It writes the exact database queries needed to link an applicant to a specific recruiter's campaign.

Setup guide

Set up Gem MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Gem MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Gem transactions." If the MCP tools are loaded correctly, Cursor will call the Gem tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "gem-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Cursor

Create an mcp.json file in your project root directory. Add the server command and arguments, then toggle Agent mode on in the chat window.

Yes, the agent executes the note listing tool to pull interaction histories. It uses that live text to help you format a custom internal dashboard component.

The AI only executes the creation tool if you explicitly tell it to. You should use a sandbox environment when testing scripts that push new records to the CRM.

It runs the project listing tool first to get the ID numbers. Then it passes those IDs into the detail fetcher to get the exact requirements.

This connection handles highly confidential applicant records and internal recruiter notes. Vinkius manages the authentication via a zero-trust architecture, meaning your API tokens never leak into the LLM training data. The environment spins down completely after your coding session.

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