Behavior Runtime MCP
Run behavior trees at about 60Hz in the browser, with triggers, recordings and audit logs
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- 1 day ago
About Behavior Runtime MCP
Behavior Runtime MCP is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.
This server executes deterministic behavior trees in a browser runtime so an agent can drive repeated browser actions without calling a model on every step. The README describes a roughly 60Hz tick loop, reactive triggers that pre-empt running behaviors by priority, shared blackboard variables, frame recordings, and a SQLite store with a SHA-256 Merkle audit chain and snapshot and restore.
Ten tools cover loading and hot-swapping a tree, setting parameters, reading status and tick history, aborting, pausing or resuming, registering triggers, capturing and listing action recordings, metrics, managing immutable behavior definitions and the blackboard, and runtime database diagnostics. A five-layer safety stack is listed: unknown nodes fail closed, the tick loop never blocks on network calls, execution requires signed dispatch tokens using an HMAC secret, a 60 actions-per-second limiter and policy gate blocks irreversible mutations, and an emergency kill switch with a watchdog halts execution if a tick stalls beyond 5 seconds.
It installs from npm (npx @putervision/behavior-mcp init, doctor and inspect), runs over stdio and is MIT licensed, with 266 tests reported in the README.
Install
Run in a terminal
claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"behavior-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"behavior-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"behavior-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"behavior-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"behavior-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/behavior-mcp"
]
}
}
}Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- load_behavior
- Loads, unloads or hot-swaps a behavior tree in the browser runtime.
- set_parameters
- Sets, gets or resets runtime parameters.
- get_status
- Returns active status, node path and tick count.
- abort_behavior
- Aborts, pauses or resumes behavior execution.
- register_trigger
- Registers or lists reactive interrupt triggers.
- replay_recording
- Captures or lists deterministic action recordings.
- get_metrics
- Returns runtime telemetry and tick durations.
- manage_behaviors
- Registers, gets or lists immutable behavior tree definitions.
- manage_blackboard
- Reads or writes blackboard variables.
- manage_runtime_db
- SQLite stats, audit, snapshot and restore.
What it does
- 60Hz tick loop
- Executes behavior trees at high frequency inside the browser.
- Reactive triggers
- Pre-empts running behaviors by priority when conditions fire.
- Blackboard state
- Shares variables between nodes and the agent.
- Action recordings
- Captures deterministic browser action sequences for replay.
- Audit chain
- Logs runtime events in a SHA-256 Merkle ledger with snapshot restore.
- Safety guardrails
- Adds fail-closed evaluation, rate limits, a kill switch and a watchdog.
Good for
- Run a scripted browser workflow without a model call per step
- Interrupt a running behavior when a condition changes
- Record and replay an action sequence
- Monitor tick duration and stuck events
- Roll back runtime state from a checkpoint
Pricing
Open source
Free MIT-licensed npm package
Prices change. Check behaviormcp.com before you buy.
Behavior Runtime MCP FAQ
How do I start?
Run npx @putervision/behavior-mcp init, then doctor and inspect.
What transport does it use?
stdio, added to .cursor/mcp.json or .vscode/mcp.json.
How is runaway execution prevented?
A 60 actions per second limiter, a policy gate, a kill switch and a watchdog that halts after 5,000 ms without a tick.
What licence is it under?
MIT.
Is Behavior Runtime MCP free?
Yes. Behavior Runtime MCP is open source, so you can use and self-host it for free.
How do I add Behavior Runtime MCP to Claude Code?
Run this command in your terminal: claude mcp add behavior-mcp -- npx -y @putervision/behavior-mcp
What are the best alternatives to Behavior Runtime MCP?
The closest alternatives to Behavior Runtime MCP are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.
Alternatives to Behavior Runtime MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools