How to Use the Convai MCP in Cursor

Q: How do I test Convai voice settings inside Cursor?

You can query available voices. Your agent calls listvoices to retrieve the active providers and updates your character's voice settings using updatecharacter.

Q: Can I debug player chat histories within the editor?

You can pull live logs. Your agent runs listchatsessions and getchatsessiondetails to show you exactly what players said and how the character responded.

Code and test Convai game characters directly in your Cursor editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Convai MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct NPC Code Generation in Cursor

The `create_character` tool allows your agent to spin up new game entities directly from your active code files. When writing your game loop, your agent runs `get_character` to inspect the NPC's properties and generate matching code structures. This direct connection means you never write boilerplate code based on stale API docs. Your code editor reads the live schema, grabs the voice ID with `list_voices`, and writes the integration code for you.

Local Lore Syncing via Cursor Agent

The `update_knowledge_bank` tool syncs your local markdown files and game design documents with the Convai platform. Your agent scans your workspace, detects changes in your lore files, and pushes them using `upload_knowledge_bank`. You don't have to drag and drop files into a browser portal anymore. The MCP Server handles the transfer in the background while you focus on writing game mechanics.

Live Dialogue Testing and Narrative Triggers

The `create_narrative_trigger` tool defines how your game world events interact with your character's dialogue tree. Your agent uses `edit_narrative_section` to modify branching paths based on the code you are writing. To verify the logic, you run `get_response` to simulate player interactions inside your editor's terminal. This makes debugging complex game states fast and keeps your code aligned with your narrative design.

Setup guide

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

.cursor/mcp.json

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

Add the MCP Server details to your local or global mcp.json file. Once saved, the Cursor agent can immediately call tools like `list_characters` to read your account data.

Yes, your agent can write and manage narrative paths. It uses `create_narrative_section` to build out dialogue steps directly from your editor.

You can query available voices. Your agent calls `list_voices` to retrieve the active providers and updates your character's voice settings using `update_character`.

You can pull live logs. Your agent runs `list_chat_sessions` and `get_chat_session_details` to show you exactly what players said and how the character responded.

Your character backstories and narrative triggers are shielded by Vinkius's zero-trust MCP infrastructure. Only authorized calls from your local editor can touch your Convai assets.

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