Convai Connector for AI agents.

25 live capabilities

Build and manage lifelike NPCs with deep backstories and knowledge banks.

Live agent request Convai / Connector

Waiting for input…

AI Agent

Why people use Convai

Convai for Building Complex NPCs in Games

This Connector changes that by letting you manage the entire lifecycle of your characters in one place. You can create, update, and organize your NPCs using your AI client, ensuring every character has a consistent personality and a reliable knowledge base.

What Vinkius changes

You get a direct way to build and manage complex conversational characters through your AI agent.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

The RPG World Builder

A designer wants a city of 20 NPCs.
Real-world use case 02

The Educational App

A dev needs a tutor character.
Real-world use case 03

The Narrative Designer

Someone is mapping a quest.

Complete set · 25capabilities

The complete Convai capability set.

These are the exact actions your AI can choose when you ask it to work with Convai.

Capability set01 / 07

01—04

4 capabilities in this set.

Part of 25 available through Convai.

01 Capability
Delete knowledge bank
Delete a specific file from a knowledge bank. This keeps your character's information current and relevant.
02 Capability
Edit narrative section
Change the details of an existing narrative section. Use this to tweak story beats as you iterate on your design.
03 Capability
Evaluate conversation
Grade a chat transcript based on your specific criteria. This helps you identify where your NPCs might be failing.
04 Capability
Generate backstory
Have the AI write a detailed description for a new character. This saves you from staring at a blank page during design.

Capability set02 / 07

05—08

4 capabilities in this set.

Part of 25 available through Convai.

05 Capability
Generate starter conversation
Create follow-up options for a character's first interaction. This helps guide the user into the story more naturally.
06 Capability
Get character
Pull all the data for a specific character. Use this to check the current settings, voice, and backstory of an NPC.
07 Capability
Get chat session details
Look at the specifics of a single chat session. This is great for deep-diving into a specific user interaction.
08 Capability
Get prompt
Fetch the raw prompt data for debugging or deep config. Use this when you need to see exactly what the engine is processing.

Capability set03 / 07

09—12

4 capabilities in this set.

Part of 25 available through Convai.

09 Capability
Get response
Get a direct response from a character for testing. This lets you verify a character's behavior without a full chat session.
10 Capability
List characters
See every character associated with your account. Use this to get a high-level overview of your entire character fleet.
11 Capability
List knowledge bank
Check the status of your character's knowledge bank. Use this to see which documents are currently active.
12 Capability
List narrative sections
View all the different narrative sections in a character's story. It helps you organize the flow of a branching path.

Capability set04 / 07

13—16

4 capabilities in this set.

Part of 25 available through Convai.

13 Capability
List narrative triggers
See the triggers that cause narrative changes. Use this to audit the logic of your story progression.
14 Capability
List voices
See all available voices sorted by their provider. You can use this to find the right tone for a specific character.
15 Capability
Toggle narrative
Turn narrative driven mode on or off for a character. This lets you switch between free-form chat and guided story.
16 Capability
Update character
Modify the details of an existing character. This is the best way to iterate on a character's personality over time.

Capability set05 / 07

17—19

3 capabilities in this set.

Part of 25 available through Convai.

17 Capability
List chat sessions
See a list of all chat sessions for a specific character. This helps you track how users are interacting with your NPCs.
18 Capability
List languages
See which languages the characters can speak. This is useful for checking global accessibility for your app.
19 Capability
Connect live
Open a live connection to the API via WebRTC for real-time testing. You can hear and see character responses instantly.

Capability set06 / 07

20—22

3 capabilities in this set.

Part of 25 available through Convai.

20 Capability
Create character
Make a new character with a name, backstory, and voice. This is the primary way to add new beings to your project.
21 Capability
Create narrative section
Add a new section to a character's branching story. This helps you build out complex quest lines or dialogue trees.
22 Capability
Create narrative trigger
Create a new trigger to move the story forward. Use this to make the world react to specific player choices.

Capability set07 / 07

23—25

3 capabilities in this set.

Part of 25 available through Convai.

23 Capability
Delete character
Remove a character from your account. Use this to clean up old test characters or retired NPCs.
24 Capability
Update knowledge bank
Change or update a file in a knowledge bank. Use this to keep your character's facts current as your project evolves.
25 Capability
Upload knowledge bank
Put a new file into your character's knowledge bank. This is how you give your characters deep domain expertise.

Set up in minutes

One URL. Then ask Convai to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Convai from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Convai, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Convai for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Convai URL.
Step 03

Save and start

Save the connection and enable Convai in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "convai": {
      "url": "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Convai

Open Agent mode in chat and ask: "Using Convai, help me...". 25 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "convai": {
      "url": "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Convai

Ask Copilot: "Using Convai, help me...". 25 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "convai": {
      "url": "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Convai

Open Cascade and ask: "Using Convai, help me...". 25 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "convai": {
      "url": "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Convai

Ask Cline: "Using Convai, help me...". 25 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add convai --transport http "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Convai

Ask Claude: "Using Convai, show me...". 25 tools are ready

Where the request belongs

Work Convai can move forward.

Built around the request

This is for game developers and narrative designers who are tired of hand-coding every line of dialogue or manually updating NPC knowledge. It's for the person who needs to manage 50 different characters and wants to do it without losing their mind.

01

Game Developer

Build and iterate on NPC personalities and backstories directly in your workspace.

02

Narrative Designer

Map out complex story triggers and narrative sections without leaving your AI assistant.

03

AI Researcher

Evaluate conversation quality and manage knowledge banks for specialized conversational agents.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 6 capabilities

BotGenuity

Create and manage AI chatbots with custom knowledge bases that answer customer questions accurately around the clock.

02 19 capabilities

Inworld AI

Power your AI agents with Inworld's lifelike voices, voice cloning, and advanced character orchestration routers.

03 11 capabilities

Retell AI

Build human-like AI voice agents that handle phone calls, answer questions, and complete tasks through natural spoken conversation.

04 12 capabilities

Voiceflow

Design, prototype, and launch conversational AI agents with a visual builder that handles complex dialog flows without code.

05 10 capabilities

rct.ai

Create AI-powered NPCs and metaverse scenarios. manage autonomous virtual beings and narrative logic directly from any AI agent.

06 8 capabilities

Bot9

Manage your AI agents via Bot9. orchestrate bots, train them, and automate conversations directly from any AI agent.

Bring your own AI

Change the model, client or framework. Keep Convai connected.

Before you connect

Questions about Convai.

The practical details behind the request, access and result.

What is Convai MCP for?

The Convai MCP is for building and managing lifelike NPCs and digital characters. It lets you give your AI agents the ability to have distinct personalities, specific backstories, and complex narrative behaviors for games or apps.

Can I give my characters specific facts using Convai MCP?

Yes. You can use the knowledge bank feature to upload documents. This gives your characters deep expertise on specific topics, like a company handbook or a fictional world's history.

How do I manage story branches with Convai MCP?

You can create narrative sections and triggers. This allows you to map out different paths a conversation can take based on what the user says or does, creating a branching story experience.

Can I hear the character voices with Convai MCP?

Yes. You can connect to the Live API via WebRTC to hear and see character responses in real time. This is perfect for testing how a character sounds before you launch your project.

How do I know if my NPCs are behaving correctly?

You can use the evaluation capability to grade chat transcripts. It looks at conversations based on your custom rules to see if the characters are staying in character and providing good info.

Can I manage many characters at once with Convai MCP?

Absolutely. You can list all the characters associated with your account and update their details, voices, or knowledge banks quickly without having to do it one by one manually.

How do I create a new character with a specific voice?

Use the create_character capability. You can specify the charName, backstory, and voiceType. To see available voices, run the list_voices query first.

Can I give my character custom documents to learn from?

Yes! Use the upload_knowledge_bank capability to add files. Once uploaded, you can link them to your character using the update_character capability by passing the document IDs in the docs field.

How can I test a character's response to a specific input?

You can use the get_response capability. Provide the charID and the user text, and the agent will return the character's generated response along with any triggered actions.

One connection away

Give your agent a direct line to Convai.

Connect Convai once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available