English Français العربية

Behavior Runtime MCP

Official registry Search and web

In-browser ~60Hz behavior tree execution engine with reactive triggers and blackboard projection.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @putervision/behavior-mcp
Claude Code 
claude mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp@0.4.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "behavior-runtime-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@putervision/behavior-mcp@0.4.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @putervision/behavior-mcp
  2. ⚡ 15-Second Quick Start
  3. 🛠️ 10 Core MCP Tools
  4. 🛡️ 5-Layer Safety Guardrail Stack & System 1 Invariants
  5. 📚 Deep Documentation Guides
  6. 🔗 Client Configuration & Environment
  7. 🧪 Testing
  8. 📄 License

@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

ToolActionsPurpose
load_behaviorload, unload, swapInject, initialize, or hot-swap a behavior tree in browser runtime
set_parametersset, get, resetDynamically update or query runtime execution parameters
get_statuscurrent, history, tree_stateQuery active status, node traversal path, tick count, duration
abort_behaviorabort, pause, resumeHalt, pause, or resume behavior execution safely
register_triggerregister, listConfigure reactive interrupt triggers with priority preemption
replay_recordingcapture, listCapture or inspect deterministic browser action sequences
get_metricscurrent, historyRetrieve runtime telemetry, tick durations, and stuck events
manage_behaviorsregister, get, listCRUD for immutable behavior tree JSON with SHA-256 tree hashes
manage_blackboardget, setRead, write, or query shared behavior tree blackboard variables
manage_runtime_dbstats, audit, snapshot, restoreSQLite diagnostics, SHA-256 Merkle audit, and checkpoint rollback

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

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

📚 Deep Documentation Guides

🔗 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

Frequently asked questions

What is Behavior Runtime MCP?

In-browser ~60Hz behavior tree execution engine with reactive triggers and blackboard projection.

How do I install Behavior Runtime MCP?

It runs on your machine. In Claude Code: claude mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp@0.4.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Behavior Runtime MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Behavior Runtime MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Behavior Runtime MCP?

It is published by putervision. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.