Behavior Runtime MCP — Claude Code MCP server: setup and use
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.
claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcpWhat Behavior Runtime MCP 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.
What it helps with
- 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 for the agent
- 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.
How to install Behavior Runtime MCP
Platform CLI
claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcpPlatform CLI
codex mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcpConfig file
{
"mcpServers": {
"behavior-runtime-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Config file
{
"servers": {
"behavior-runtime-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Platform CLI
gemini mcp add behavior-runtime-mcp npx -y @putervision/behavior-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Behavior Runtime MCP
How do I install Behavior Runtime MCP in Claude Code?
Run claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcp. The server will then be available to Claude Code as an MCP server.
What does Behavior Runtime MCP do?
It executes behavior trees in a browser runtime and lets an agent control triggers, parameters, execution state, recordings, metrics, and blackboard data.
What does the server require?
It requires Node.js >=20.0.0. Set PENTAD_HMAC_SECRET when signed intention checks are needed.
