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 Oct 1, 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.

get_character

Supply the required character ID. Get details for a specific Convai character

list_knowledge_bank

Supply the required listing details in the payload. List Knowledge Bank status

delete_character

Supply the character ID. Delete a Convai character

delete_knowledge_bank

Include the necessary deletion details in the payload. Delete a Knowledge Bank file

get_chat_session_details

Provide both the character ID and session ID. Get details of a specific chat session

list_characters

Use this function to retrieve the full list of characters. Returns all characters associated with the account

list_chat_sessions

Use the character ID to filter results. List chat sessions for a character

list_languages

Returns supported languages

list_narrative_triggers

Pass a JSON payload to specify filtering or listing criteria. List narrative triggers

toggle_narrative

Pass a JSON payload containing the required state change. Toggle narrative driven mode for a character

upload_knowledge_bank

Provide both the file name and content. Upload a file to the Knowledge Bank

create_narrative_section

Pass a JSON payload detailing the section’s content and properties. Create a narrative section

list_voices

Returns available voices categorized by provider

connect_live

Specify the character ID and desired connection type. Connect to Live API via WebRTC

create_character

Provide all necessary details, including name and voice type. Create a new Convai character

create_narrative_trigger

Pass a JSON payload defining the trigger’s conditions and actions. Create a narrative trigger

edit_narrative_section

Pass a JSON payload containing the section ID and updated data. Edit a narrative section

evaluate_conversation

Include the conversation history in the prompt. Evaluate a conversation transcript based on custom attributes

generate_backstory

Provide a high-level description and the desired character name. Generate a character description

generate_starter_conversation

Pass the required conversation details in the payload. Generate follow-up options

get_prompt

Supply both the session and character IDs. Fetch prompt data for debugging or advanced configuration

get_response

Use a session ID of "-1" for starting a new conversation. Get a response from a character

list_narrative_sections

Pass a JSON payload to specify filtering or listing criteria. List narrative sections

update_character

Must provide the character ID to target the update. Update an existing Convai character

update_knowledge_bank

Pass the full update details in the payload. Update a Knowledge Bank file

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