board_create
Build a board scene whose children are addressable cells (each a cell_<id> node in the board_cells group) from a ring, grid, or explicit-cells layout. Cells are Marker2D (or Control) anchors positioned by pure layout math; an optional background (color or res:// art) sits behind them. General-pur...
This record as markdown: /tools/breakpoint-mcp/board-create.md
What board_create does on Breakpoint
AI agents use board_create to create or update resources in Breakpoint, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Breakpoint environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Where to save the board scene, e.g. res://ui/board/Board.tscn |
layout | object | Yes | ring{cells[]} | grid{rows,cols} | cells{cells[{id,x,y}]} |
confirm | boolean | — | Auto-approve this destructive action (skip the confirmation prompt) |
cell_kind | string | — | marker→Marker2D anchor (default), control→Control anchor |
cell_size | number | — | Cell pitch in px (drives ring radius / grid spacing; default 96) |
overwrite | boolean | — | Overwrite an existing board at `path` (default false) |
root_type | string | — | Board root node type (default Node2D) |
background | object | — | Optional background drawn behind the cells |
Parameters from the server's own tool schema.
Why board_create is rated Medium
While the description uses the word 'DESTRUCTIVE' and the tool writes scene data, the confirmation gate and reversibility via scene undo/reload systems place this in Write rather than Destructive. The tool creates or modifies scene structure (creating nodes, positioning them, applying styling) without permanently deleting data.
From the tool's definition Tool description states it 'Build a board scene' and 'writes a scene', creating node hierarchies (board_cells group with cell_<id> nodes).
Risk signalsAccepts file system path (path) · High parameter count (13 properties)
Attacks that exploit this kind of access
The rule that runs board_create safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Breakpoint, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For board_create, this is the rule to start with:
board_create stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Breakpoint, apply this rule, and every board_create call is checked against it from then on.
Questions about board_create
Build a board scene whose children are addressable cells (each a cell_<id> node in the board_cells group) from a ring, grid, or explicit-cells layout. Cells are Marker2D (or Control) anchors positioned by pure layout math; an optional background (color or res:// art) sits behind them. General-purpose — cells carry only caller-supplied ids. DESTRUCTIVE (writes a scene) — gated by confirmation. Returns the cell_id → node_path + position map. It is categorised as a Write tool in the Breakpoint MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
board_create accepts 8 parameters: path, layout, confirm, cell_kind, cell_size, overwrite, root_type, background. Required: path, layout. The full parameter table on this page comes from the server's own tool schema.
Register the Breakpoint MCP server in PolicyLayer and add a rule for board_create: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Breakpoint. Nothing to install.
board_create is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the board_create rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for board_create. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
board_create is provided by the Breakpoint MCP server (breakpoint-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Breakpoint, and thousands of servers like it.
This server
Across the catalogue