# Behavior Runtime MCP

This MCP server runs behavior trees in a browser runtime, reacts to triggers, and exposes execution state. It suits AI-agent workflows with explicit control logic.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: putervision
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/putervision/behavior-mcp
- Updated: 2026-10-03
- HTML: https://affpapa.org/en/nevibecode/mcp/behavior-runtime-mcp

## What it does

Behavior Runtime MCP runs deterministic behavior trees inside a browser environment. An agent can load, replace, or remove a tree, change runtime parameters, inspect traversal state, and pause or stop an active run. Shared values are exposed through a blackboard.

The server also handles prioritized reactive triggers, captures browser action sequences, and reports runtime metrics. SQLite stores runtime records; behavior trees and audit entries use SHA-256 hashes, with database snapshots and restores available. Node.js `>=20.0.0` is required, and intention checks depend on `PENTAD_HMAC_SECRET`. Without that secret, signed dispatch tokens cannot pass verification.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "behavior-runtime-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@putervision/behavior-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "behavior-runtime-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@putervision/behavior-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add behavior-runtime-mcp npx -y @putervision/behavior-mcp
```

## When to use it
- run behavior trees inside a browser
- interrupt an active run with a priority trigger
- inspect shared blackboard values
- pause, resume, or abort execution
- review runtime history and tick metrics

## Example prompts
- Load the behavior tree in the browser and show its current execution state.
- Register a high-priority trigger that interrupts the active behavior.
- Read the blackboard values and the execution history for this tree.

## Similar
- [unreal-behavior-trees](https://affpapa.org/en/nevibecode/skills/unreal-behavior-trees.md) — skill · 5400 installs
- [ue-ai-navigation](https://affpapa.org/en/nevibecode/skills/ue-ai-navigation.md) — skill · 1100 installs
- [ui-ticket-mcp](https://affpapa.org/en/nevibecode/mcp/ui-ticket-mcp.md) — MCP server · ★ 9
- [ai-behavior-trees-utility-ai](https://affpapa.org/en/nevibecode/skills/ai-behavior-trees-utility-ai.md) — skill · 5100 installs
- [mapbox-mcp-runtime-patterns](https://affpapa.org/en/nevibecode/skills/mapbox-mcp-runtime-patterns.md) — skill · 1400 installs
- [experience-lwc-runtime-observe](https://affpapa.org/en/nevibecode/skills/experience-lwc-runtime-observe.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md