How to Use the R2R MCP in Cursor

Q: How does R2R search work in Cursor?

The AI triggers the search tool in the background when you ask a question. It then uses the returned vector matches to inform the code it writes.

Q: Can I use R2R to list documents in Cursor?

Yes, the listdocuments tool is available in your agent's toolkit. It displays your indexed files right in the editor chat interface.

Q: Is R2R health monitoring available in Cursor?

Use gethealth to check your connection status. It ensures your R2R server is responding before the AI attempts to run heavy queries.

Integrate R2R with Cursor to inject live project context into your code generation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect R2R MCP to Cursor

Create your Vinkius account to connect R2R to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup R2R with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Contextual coding with R2R and Cursor

Enable Agent mode in Cursor to let the AI call `rag_query` while writing code. It pulls real documentation or technical specs from your R2R engine to write accurate implementation logic. You get code that understands your existing project architecture. No more guessing or hallucinations; just relevant data injected into your active file.

Semantic search for Cursor developers

Use the `search` tool to find implementation patterns across your entire document store. Cursor treats the search results as live context during the edit process. It helps you find obscure logic you wrote months ago. Point the AI at your vector store and let it find the exact function definitions or requirements you need.

Manage R2R documents via Cursor

Use `list_documents` to see what files are indexed without switching windows. If you need to verify a specific file's content, `get_document` provides the raw details immediately. This keeps your development flow moving. You can audit your knowledge base while staying inside your editor's terminal or chat.

Setup guide

Set up R2R 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 R2R 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 R2R transactions." If the MCP tools are loaded correctly, Cursor will call the R2R tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "r2r-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 R2R. 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 R2R 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 R2R MCP in Cursor

The AI triggers the `search` tool in the background when you ask a question. It then uses the returned vector matches to inform the code it writes.

Yes, the `list_documents` tool is available in your agent's toolkit. It displays your indexed files right in the editor chat interface.

Use `get_health` to check your connection status. It ensures your R2R server is responding before the AI attempts to run heavy queries.

Add the server details to your .cursor/mcp.json file. Once saved, Cursor will automatically detect the available tools for your agent.

Data access is restricted to the tools you explicitly allow. The R2R server processes your document text locally or within your private cloud, ensuring no external training on your source files.

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