How to Use the Gem MCP in LlamaIndex

Q: How do I configure LlamaIndex to use the Gem MCP Server?

Install llama-index-tools-mcp and set up a BasicMCPClient. Pass the client to McpToolSpec to generate the tool list for your querying agent.

Q: How does LlamaIndex know which Gem outreach sequences exist?

The system calls listoutreachsequences to pull the active templates. It indexes these templates so recruiters can search for the best messaging strategy based on past success.

Q: Does LlamaIndex test the Gem connection before indexing?

You should run verifyapiconnection during your initialization script. This prevents the indexing job from failing halfway through due to an expired API token.

Index your entire Gem candidate database into LlamaIndex to build searchable, hallucination-free recruiting RAG applications.

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 LlamaIndex

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Indexing candidate profiles

LlamaIndex treats your CRM data as a live knowledge base through this MCP integration. By calling `list_candidates` and `get_candidate_details`, your application pulls raw profile data and embeds it directly into your vector store for semantic search. This means you stop guessing who sits in your pipeline. A hiring manager queries the index for specific React experience, and the system retrieves exact matches grounded in actual database records rather than making up names.

RAG for recruiting history

Past conversations dictate future response rates. Your application executes `list_candidate_notes` to extract every recruiter touchpoint and embeds those interactions alongside the candidate's core profile. You build a complete timeline of engagement. When a sourcer asks if someone was contacted recently, the agent searches the index and reads the exact notes. The MCP protocol ensures the system uses `add_candidate_note` to log any new interactions back to the source of truth.

Gem MCP Server mapping

You need to map candidates to the right internal structures. The agent reads your active job requisitions using `list_talent_projects` and indexes the requirements against your available talent pool. It connects the dots between open headcount and past applicants. It also pulls your internal team hierarchy via `list_recruiting_team` and custom field definitions using `list_crm_custom_fields`. This context ensures your RAG application understands your specific organizational language when answering internal queries.

Setup guide

Set up Gem MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all Gem MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to Gem tools.",
)
response = await agent.run("List recent Gem data")

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 LlamaIndex

Install `llama-index-tools-mcp` and set up a `BasicMCPClient`. Pass the client to `McpToolSpec` to generate the tool list for your querying agent.

Yes. While RAG applications usually focus on reading data, passing the `update_crm_candidate` tool to your `FunctionAgent` allows it to write changes back to the CRM.

The system calls `list_outreach_sequences` to pull the active templates. It indexes these templates so recruiters can search for the best messaging strategy based on past success.

You should run `verify_api_connection` during your initialization script. This prevents the indexing job from failing halfway through due to an expired API token.

The integration handles highly confidential salary expectations and diversity metadata stored in custom fields. Vinkius operates a zero-trust architecture where the tool executor holds no persistent state, dropping the connection the millisecond the vector store receives the payload.

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