How do I install the Behavior MCP skill?

Run npx skillmds@latest add putervision/behavior-mcp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Behavior MCP safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Behavior MCP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Behavior MCP free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Behavior MCP?

putervision (@putervision) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Behavior MCP by putervision — Agent Skill

Name: Behavior MCP
Rating: 4.2 (5 reviews)
Author: putervision

File contents

Behavior Runtime Engine (behavior-mcp)

This skill provides step-by-step guidance and operational patterns for interacting with @putervision/behavior-mcp with project slug "world-model-mcp".

1. Role in the PuterVision Pentad

Workflow State (state-memory-mcp): Persistent task DAGs, decisions, milestones, and blockers.
Perception (vision-memory-mcp): Visual layout caching, screenshots, and visual specifications.
Spatial World (world-model-mcp): Persistent 3D/2D coordinates, bounding boxes, and topological relations.
Strategic Reasoning (agent-reasoning-mcp): Strategic BDI goals, utility scoring, and intention dispatch.
Tactical Execution (behavior-mcp): High-frequency (~60Hz) deterministic behavior tree execution directly in browser runtimes with reactive interrupts.

2. Core Operational Sequence

Define or Load Behavior: Call load_behavior with action: "load" to inject and start tree execution.
Register Reactive Triggers: Configure emergency preemption using register_trigger with priority and cooldown guards.
Monitor Telemetry: Poll execution health, tick rates, and active traversal nodes with get_status.
Runtime Blackboard: Read and mutate execution variables via manage_blackboard.
Safety Guardrails: Immediately halt or pause rogue states using abort_behavior.

3. Complete 10 Consolidated MCP Tools Reference

Tool Name	Key Actions	Key Parameters	Description
`load_behavior`	`load`, `unload`, `swap`	`behavior_name`, `behavior_version`, `parameters`, `intention_id`	Hot-swap, inject, or initialize behavior tree instances in browser runtime.
`set_parameters`	`set`, `get`, `reset`	`execution_id`, `parameters`	Dynamically update or query execution parameters for the active tree.
`get_status`	`current`, `history`, `tree_state`	`execution_id`, `limit`	Query active behavior status, current node path, tick count, duration, and errors.
`abort_behavior`	`abort`, `pause`, `resume`	`execution_id`, `reason`	Immediately halt, pause, or resume execution and disengage active inputs.
`register_trigger`	`register`, `list`	`name`, `condition_type`, `priority`, `cooldown_ms`, `behavior_name`	Configure reactive interrupt triggers with priority preemption and cooldowns.
`replay_recording`	`capture`, `list`	`recording_id`, `execution_id`, `frames`, `name`	Capture or replay deterministic browser action sequences with adaptive timing.
`get_metrics`	`current`, `history`, `aggregate`, `compare`	`execution_id`, `behavior_name`, `limit`	Retrieve execution telemetry, tick durations, stuck events, and statistics.
`manage_behaviors`	`register`, `list`, `get`	`name`, `version`, `tree`, `tree_json`, `description`	CRUD operations for immutable JSON behavior trees with SHA-256 tree hash verification.
`manage_blackboard`	`get`, `set`	`execution_id`, `key`, `value`	Read or write shared behavior tree blackboard state variables.
`manage_runtime_db`	`stats`, `audit`, `snapshot`, `diff`, `restore`	`action`, `name`, `description`	Database maintenance, diagnostics, and SHA-256 Merkle audit verification.

---name: behavior-mcpdescription: Teaches the agent to use the Behavior MCP server for ~60Hz in-browser behavior trees, triggers, and recordings.---# Behavior Runtime Engine (behavior-mcp)This skill provides step-by-step guidance and operational patterns for interacting with `@putervision/behavior-mcp` with project slug `"world-model-mcp"`.---## 1. Role in the PuterVision Pentad- **Workflow State** (`state-memory-mcp`): Persistent task DAGs, decisions, milestones, and blockers.- **Perception** (`vision-memory-mcp`): Visual layout caching, screenshots, and visual specifications.- **Spatial World** (`world-model-mcp`): Persistent 3D/2D coordinates, bounding boxes, and topological relations.- **Strategic Reasoning** (`agent-reasoning-mcp`): Strategic BDI goals, utility scoring, and intention dispatch.- **Tactical Execution** (`behavior-mcp`): High-frequency (~60Hz) deterministic behavior tree execution directly in browser runtimes with reactive interrupts.---## 2. Core Operational Sequence1. **Define or Load Behavior**: Call `load_behavior` with `action: "load"` to inject and start tree execution.2. **Register Reactive Triggers**: Configure emergency preemption using `register_trigger` with priority and cooldown guards.3. **Monitor Telemetry**: Poll execution health, tick rates, and active traversal nodes with `get_status`.4. **Runtime Blackboard**: Read and mutate execution variables via `manage_blackboard`.5. **Safety Guardrails**: Immediately halt or pause rogue states using `abort_behavior`.---## 3. Complete 10 Consolidated MCP Tools Reference| Tool Name | Key Actions | Key Parameters | Description ||---|---|---|---|| `load_behavior` | `load`, `unload`, `swap` | `behavior_name`, `behavior_version`, `parameters`, `intention_id` | Hot-swap, inject, or initialize behavior tree instances in browser runtime. || `set_parameters` | `set`, `get`, `reset` | `execution_id`, `parameters` | Dynamically update or query execution parameters for the active tree. || `get_status` | `current`, `history`, `tree_state` | `execution_id`, `limit` | Query active behavior status, current node path, tick count, duration, and errors. || `abort_behavior` | `abort`, `pause`, `resume` | `execution_id`, `reason` | Immediately halt, pause, or resume execution and disengage active inputs. || `register_trigger` | `register`, `list` | `name`, `condition_type`, `priority`, `cooldown_ms`, `behavior_name` | Configure reactive interrupt triggers with priority preemption and cooldowns. || `replay_recording` | `capture`, `list` | `recording_id`, `execution_id`, `frames`, `name` | Capture or replay deterministic browser action sequences with adaptive timing. || `get_metrics` | `current`, `history`, `aggregate`, `compare` | `execution_id`, `behavior_name`, `limit` | Retrieve execution telemetry, tick durations, stuck events, and statistics. || `manage_behaviors` | `register`, `list`, `get` | `name`, `version`, `tree`, `tree_json`, `description` | CRUD operations for immutable JSON behavior trees with SHA-256 tree hash verification. || `manage_blackboard` | `get`, `set` | `execution_id`, `key`, `value` | Read or write shared behavior tree blackboard state variables. || `manage_runtime_db` | `stats`, `audit`, `snapshot`, `diff`, `restore` | `action`, `name`, `description` | Database maintenance, diagnostics, and SHA-256 Merkle audit verification. |

Frequently asked questions

Behavior MCP