How to Use the Convai MCP in VS Code Copilot

Q: Can we update Convai NPC backstories using VS Code Copilot?

Yes, your agent can edit them. It uses generatebackstory to write descriptions and updatecharacter to apply them to your Convai profile.

Q: Can we manage character voices through this integration?

Yes, you can query and assign voices. Your agent calls listvoices to see what is available and updates your character profiles accordingly.

Manage team-wide Convai game narratives directly inside VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect Convai to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Team-Wide NPC Asset Control in VS Code

The `list_characters` tool gives your development team a shared view of all active game characters directly inside the editor. Your agent pulls this list so developers can inspect backstories using `get_character` without leaving their workspace. By committing the MCP Server configuration to your repository, every engineer on the team gets instant access to these tools. This keeps your entire team aligned on character configurations and voice assets.

Automated Narrative Branching and Triggers

The `create_narrative_section` tool allows your team to script complex NPC dialogue paths directly from your codebase. Your agent uses `create_narrative_trigger` to bind specific game triggers to narrative states. You can toggle narrative-driven modes on or off using `toggle_narrative`. This lets developers programmatically control whether a character follows a strict script or chats freely.

Lore Bank Integration and File Syncing

The `upload_knowledge_bank` tool keeps your game's lore documents in sync with your active characters. Your agent monitors your team's markdown documentation and updates the Convai platform using `update_knowledge_bank`. If a document becomes obsolete, you can remove it using `delete_knowledge_bank`. This ensures your NPCs always talk to players using the latest, most accurate game lore.

Setup guide

Set up Convai MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Convai MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Convai tools listed. Try asking: "List my recent Convai transactions" and Copilot will invoke them automatically.

.vscode/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 VS Code Copilot

Save the MCP Server configuration in your project's .vscode/mcp.json file and commit it to Git. This lets every team member use tools like `list_characters` automatically.

Yes, your agent can edit them. It uses `generate_backstory` to write descriptions and `update_character` to apply them to your Convai profile.

You can run audits directly in the chat panel. Your agent uses `evaluate_conversation` to analyze transcripts and score them against your custom game metrics.

Yes, you can query and assign voices. Your agent calls `list_voices` to see what is available and updates your character profiles accordingly.

Your uploaded knowledge bank files and narrative triggers are isolated within ephemeral V8 MCP sandboxes. No proprietary game data is stored permanently outside your authorized Convai account.

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