DriftOS

You run an MCP server that lets any MCP-compatible client use DriftOS for intelligent conversation routing. It analyzes messages, detects topic shifts, maintains a graph of branches, and assembles relevant context so your LLM calls stay precise and organized without dumping entire histories into context.

How to use

You can run DriftOS MCP Server in two ways: as a local stdio server for in-process clients or as an HTTP server for remote clients. The stdio mode starts with the standard npm start command, while the HTTP mode runs with a transport flag to expose it over HTTP. Your DriftOS API URL must point to your DriftOS Core backend (default http://localhost:3000). Use the server to route messages to the correct topic branch, fetch the current context for LLM calls, list branches in a conversation, and inspect individual branches.

How to install

Prerequisites you need before installing this MCP server are Node.js 18+ and a running DriftOS Core backend.

# Install dependencies
npm install

# Build the MCP server bundle
npm run build

Additional notes

Configuration revolves around pointing the MCP server at your DriftOS Core and choosing how you want clients to connect. The DriftOS API URL is supplied via environment variables and must be accessible by both the stdio and HTTP modes.

export DRIFTOS_API_URL=http://localhost:3000

Tools and endpoints

The DriftOS MCP Server exposes a set of tools to manage and inspect conversations. You can route messages, fetch assembled context for LLM calls, and explore branches.

Available tools

driftos_route_message

Route a message to the appropriate branch in the DriftOS conversation graph to ensure topic continuity or shifts are handled correctly.

driftos_get_context

Retrieve the assembled context for the current LLM call, incorporating relevant facts and topic history.

driftos_list_branches

List all branches within a conversation, enabling inspection of topic structure and routing history.

driftos_get_branch

Get detailed information about a specific conversation branch, including its history and extracted facts.