Skip to content
MCP server

Behavior Runtime MCP

Run behavior trees at about 60Hz in the browser, with triggers, recordings and audit logs

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "behavior-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/behavior-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "behavior-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/behavior-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP 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
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools