Convai

Convai MCP Connector for Claude

A+

Build and manage conversational AI characters with backstory, narrative design, and knowledge banks for games and apps.

25 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your Convai account to any AI agent to orchestrate lifelike conversational characters. This MCP server provides full access to the Convai Engine, allowing you to design complex NPCs and digital beings through natural language.

What you can do

  • Character Management — Create, update, and delete characters with specific voices, backstories, and language support.
  • Narrative Design — Toggle narrative-driven modes and manage sections and triggers to create branching storylines.
  • Knowledge Integration — Upload and manage documents in the Knowledge Bank to give your characters deep domain expertise.
  • Conversation Analytics — List chat sessions, retrieve session details, and evaluate conversation quality.
  • Real-time Interaction — Generate starter conversations or connect live to test character responses and voices.

How it works

  1. Subscribe to this server
  2. Enter your Convai API Key
  3. Start building interactive characters from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Game Developers — Create and iterate on NPC personalities and backstories directly from your workspace.
  • Narrative Designers — Map out complex story triggers and narrative sections without leaving your AI assistant.
  • AI Researchers — Evaluate conversation quality and manage knowledge banks for specialized conversational agents.
npc-designconversational-ainarrative-designknowledge-basevoice-ai

25 tools expose this connector's capabilities to your AI agent.

list_chat_sessions

List chat sessions for a character

list_knowledge_bank

List Knowledge Bank status

list_languages

Returns supported languages

list_narrative_sections

List narrative sections

list_narrative_triggers

List narrative triggers

list_voices

Returns available voices categorized by provider

toggle_narrative

Toggle narrative driven mode for a character

connect_live

Connect to Live API via WebRTC

create_character

Create a new Convai character

create_narrative_section

Create a narrative section

create_narrative_trigger

Create a narrative trigger

delete_character

Delete a Convai character

delete_knowledge_bank

Delete a Knowledge Bank file

edit_narrative_section

Edit a narrative section

evaluate_conversation

Evaluate a conversation transcript based on custom attributes

generate_backstory

Generate a character description

generate_starter_conversation

Generate follow-up options

get_character

Get details for a specific Convai character

get_chat_session_details

Get details of a specific chat session

get_prompt

Fetch prompt data for debugging or advanced configuration

get_response

Get a response from a character

list_characters

Returns all characters associated with the account

update_character

Update an existing Convai character

update_knowledge_bank

Update a Knowledge Bank file

upload_knowledge_bank

Upload a file to the Knowledge Bank

See how to talk to your AI agent using Convai.

List all my Convai characters.

I've retrieved your characters. You have 3 active characters: 'Cyber Guard' (ID: char_123), 'Merchant Elara' (ID: char_456), and 'System AI' (ID: char_789).

Generate a backstory for a futuristic detective named Jax.

Using `generate_backstory`... Jax is a former Neo-Tokyo enforcer turned private eye after a high-stakes betrayal. He specializes in tracking rogue synthetics in the neon-lit underbelly of the city.

Show me the details for character ID char_123.

Fetching details for 'Cyber Guard' (char_123)... Voice: 'M-US-1', Backstory: 'A sentinel programmed to protect the vault...', Model: 'gpt-4o', Temperature: 0.7.

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

Related Connectors