@putervision/behavior

GitHub Actions

High-frequency in-browser behavior tree execution engine for autonomous AI agents — 60Hz tick loops, reactive triggers, telemetry recordings, and safety guardrails.

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "putervision-behavior-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@putervision/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @putervision/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add putervision-behavior-mcp -- npx -y @putervision/behavior-mcp@0.4.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "putervision-behavior-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@putervision/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Server facts

Local

Transport: stdio
Version: 0.4.1
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @putervision/behavior?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @putervision/behavior need an API key?

No required environment variable is listed on this record.

What transport does @putervision/behavior use?

@putervision/behavior runs locally over stdio.

When was @putervision/behavior last checked?

Last checked 2026-10-28. High-frequency in-browser behavior tree execution engine for autonomous AI agents — 60Hz tick loops, reactive triggers, telemetry recordings, and safety guardrails.

From the publisher

Documentation

@putervision/behavior-mcp

High-Frequency (~60Hz) In-Browser Behavior Tree Tactical Runtime Engine for AI Agents

@putervision/behavior-mcp is a Model Context Protocol (MCP) server that executes deterministic behavior trees directly in browser runtimes at ~60Hz with reactive trigger preemption, frame recordings, SHA-256 Merkle audit chains, and a 5-layer safety guardrail stack.

🌐 Official Documentation: putervision.com • Interactive Web Docs

⚡ 15-Second Quick Start

# 1. Initialize runtime & seed default behavior trees in your workspace
npx @putervision/behavior-mcp init

# 2. Run system diagnostic and health checks
npx @putervision/behavior-mcp doctor

# 3. Inspect active executions, blackboard state, and reactive triggers
npx @putervision/behavior-mcp inspect

🛠️ 10 Core MCP Tools

Tool	Actions	Purpose
`load_behavior`	`load`, `unload`, `swap`	Inject, initialize, or hot-swap a behavior tree in browser runtime
`set_parameters`	`set`, `get`, `reset`	Dynamically update or query runtime execution parameters
`get_status`	`current`, `history`, `tree_state`	Query active status, node traversal path, tick count, duration
`abort_behavior`	`abort`, `pause`, `resume`	Halt, pause, or resume behavior execution safely
`register_trigger`	`register`, `list`	Configure reactive interrupt triggers with priority preemption
`replay_recording`	`capture`, `list`	Capture or inspect deterministic browser action sequences
`get_metrics`	`current`, `history`	Retrieve runtime telemetry, tick durations, and stuck events
`manage_behaviors`	`register`, `get`, `list`	CRUD for immutable behavior tree JSON with SHA-256 tree hashes
`manage_blackboard`	`get`, `set`	Read, write, or query shared behavior tree blackboard variables
`manage_runtime_db`	`stats`, `audit`, `snapshot`, `restore`	SQLite diagnostics, SHA-256 Merkle audit, and checkpoint rollback

🛡️ 5-Layer Safety Guardrail Stack & System 1 Invariants

Fail-Closed Evaluator: Unrecognized node definitions throw fatal exceptions immediately.
60Hz Tick Invariant & Synchronous semantic_check: The loop never blocks on external network calls; semantic condition checks resolve synchronously against blackboard caches.
HMAC Intention Gate Verification: Intentions dispatched to execution nodes require unexpired, cryptographically signed dispatch tokens (PENTAD_HMAC_SECRET).
Action Rate Limiter & Leaf Policy Gate: Strict 60 actions/sec maximum throughput ceiling and policy guardrails blocking irreversible mutations.
Emergency Kill Switch & Watchdog Heartbeat: Atomic safety latch and watchdog timers halting execution if tick stalls beyond 5,000ms.

📚 Deep Documentation Guides

📖 Formal API Reference: Full parameter tables, type definitions, and tool schemas.
💡 Core Architecture & Concepts: Behavior tree execution model, ~60Hz loop, and trigger lifecycle.
🖥️ CLI Usage Guide: Complete CLI command reference (init, doctor, inspect, run).
💾 Database Schema: SQLite table structures, indexes, and Merkle audit ledger.
⚙️ Configuration Reference: .behavior-mcp.json parameters and environment variables.

🔗 Client Configuration & Environment

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "mcpServers": {
    "behavior-mcp": {
      "command": "behavior-mcp",
      "args": ["run"],
      "env": {
        "PENTAD_HMAC_SECRET": "your-secure-shared-secret-here"
      }
    }
  }
}

🧪 Testing

# Run full unit and integration test suite across 38 test files (266 tests)
npm test

📄 License

MIT © PuterVision