• STRUCTURE
  • LOGIC
  • CONTROL
  • HUMAN

How to design branching narratives with your AI

Connect Convai to your agent to build structured story paths. You define the segments and the logic that drives character responses.

Ask AI about this page

Short answer

How can I make my AI characters follow a specific story path?

You build the path by creating distinct narrative sections and attaching triggers to them. This allows your agent to switch logic based on specific events or player actions. You get a structured map of character behaviors.

The outcome.

Where your story logic lands.

The AI organizes your narrative into manageable pieces.

STRUCTURE

Defined story segments

The AI uses the section tool to carve your story into logical chunks. You get a clear map of where the plot moves next.

LOGIC

Reactive character triggers

Triggers link specific events to character reactions. This ensures your characters don't just wander aimlessly through the plot.

CONTROL

Active flow management

You can turn specific narrative paths on or off. This lets you test different story branches without breaking the whole setup.

HUMAN

Manual story oversight

The AI handles the technical setup of the branches, but you decide the actual plot points and dialogue. You keep the creative reins.

The workflow

What your AI does when <the thing arrives>.

Your agent handles the heavy lifting of organizing the narrative structure.

  1. Map the plot

    The agent builds the individual chapters or scenes you want to execute.

    create_narrative_section

  2. Set the rules

    The agent attaches specific conditions to those sections to control when they activate.

    create_narrative_trigger

  3. Audit the path

    The agent pulls a list of everything you have built so you can see the full scope of the story.

    list_narrative_sections

  4. Manage state

    The agent enables or disables specific narrative paths to change the current story state.

    toggle_narrative

Try it

Copy these to start.

Use these prompts to begin building your story structure.

Starting points

These are starting points. Swap out the bracketed text with your actual story details.

Convai Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Convai capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "convai-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_EEgekVAvznxJ3sswokBzGmFNeYrfePtCnlM5Gx7B/mcp"
    }
  }
}
Copy into chat04

  • Create a new narrative section called [Chapter 1: The Encounter].

  • Set up a trigger in [Chapter 1] that fires when the player [picks up the sword].

  • List all the narrative sections I have created so far.

  • Toggle the [Chapter 2: The Escape] narrative section to active.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Convai once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start directing your characters through the Vinkius interface.

Connect Convai to your AI

FAQ

How this task behaves.

  • 01

    Can the AI write the actual dialogue for my characters?

    No. The AI uses these tools to manage the structure and triggers of the story, but you are responsible for the actual writing and dialogue.

  • 02

    Will the AI delete my existing story sections?

    No. The tools provided are for creating, listing, and toggling sections. There is no tool to delete or overwrite your existing narrative data.

  • 03

    How do I see what sections I've already made?

    You can ask your agent to list all the sections you have created.

  • 04

    Can I use this to control character movement?

    No. This connector is specifically for managing narrative flow and story triggers, not for controlling physical character movement or physics.

  • 05

    Can I turn off a story branch if it's not working?

    Yes. You can use the toggle tool to turn specific narrative sections on or off.

  • More questions about Convai? The Connector page answers them. See everything the Convai Connector can do

Connect Convai to Claude, Cursor, ChatGPT & more