add_input_binding

Add key/mouse/joypad binding to action.

Server Godot @yanhuifair/godot-mcp
Category Write
Risk class Medium
Parameters 61 required

What add_input_binding does on Godot

AI agents use add_input_binding to create or update resources in Godot — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Godot environment.

ParameterTypeRequiredDescription
key object Keyboard key name (e.g. "Space", "A", "Escape") — uses physical keycode
action string Yes Existing input action name
device object Device ID (-1 for all)
joypad_axis object Joypad axis (e.g. "left_x", "right_trigger")
mouse_button object Mouse button index (1=left, 2=right, 3=middle)
joypad_button object Joypad button index

Parameters from the server's own tool schema.

Why add_input_binding needs a policy

This tool creates or modifies input action bindings, which is a reversible configuration change. It does not execute code, delete data, or trigger external operations—it simply adds a binding entry to the input map.

From the tool's definition Tool name 'add_input_binding' and description 'Add key/mouse/joypad binding to action' indicate creation/modification of input configuration settings in Godot Engine.

Questions about add_input_binding

What does the add_input_binding tool do? +

Add key/mouse/joypad binding to action. It is categorised as a Write tool in the Godot MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

What parameters does add_input_binding accept? +

add_input_binding accepts 6 parameters: key, action, device, joypad_axis, mouse_button, joypad_button. Required: action. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on add_input_binding? +

Register the Godot MCP server in PolicyLayer and add a rule for add_input_binding: 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 Godot. Nothing to install.

What risk level is add_input_binding? +

add_input_binding is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit add_input_binding? +

Yes. Add a rate_limit block to the add_input_binding 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.

How do I block add_input_binding completely? +

Set action: deny in the PolicyLayer policy for add_input_binding. 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.

What MCP server provides add_input_binding? +

add_input_binding is provided by the Godot MCP server (@yanhuifair/godot-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// THE FULL RECORD

add_input_binding is one line of Godot's registry record.

The record carries the whole server: verified identity, auth posture, risk grade, every tool classified, recommended policy — re-checked continuously.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.