figma_swap_instance

THE RISK

Medium Risk

Why figma_swap_instance needs a policy

This tool modifies the component assignment of an instance, which is a structural change to the document but not destructive (the original component and instance data remain intact). It falls under Write rather than Execute because it performs a specific document modification operation rather than arbitrary code execution.

From the tool's definition 'Swap a component instance to use a different component' — modifies an existing component reference within a Figma document without deleting data. The operation is reversible (can swap back to the original component).

Documented attack patterns abuse exactly the kind of access figma_swap_instance gives an agent:

POLICY

How to control figma_swap_instance

PolicyLayer is an MCP gateway — it sits between your AI agents and Figma MCP Bridge, and nothing reaches the server without passing your rules. This is the rule we recommend for figma_swap_instance:

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "figma_swap_instance": {
      "limits": [
        {
          "counter": "figma_swap_instance_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

figma_swap_instance 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.

Create a free account and register Figma MCP Bridge — nothing to install.
Add this policy — paste it, or build it visually.
Point your MCP client (Claude, Cursor, anything) at your gateway URL.

LIMIT THIS TOOL →

Free to start. No card required.

EXPLORE

Related tools and policies

More Figma MCP Bridge tools

Destructive figma_delete_mode Delete a mode from a variable collection. Cannot delete the last mode. Destructive figma_delete_nodes Delete nodes. Destructive figma_delete_page Delete a page from the Figma document. Cannot delete the last remaining page. Destructive figma_delete_variable_collection Delete a variable collection and all its variables. Use with caution - this cannot be undo Destructive figma_delete_variables Delete one or more variables from the document. Use with caution - this cannot be undone. Destructive figma_remove_reaction Prototype: remove a reaction from a node by its zero-based index in the reactions array. U Destructive figma_remove_table_column FigJam: remove the column at the given index. Destructive figma_remove_table_row FigJam: remove the row at the given index.

All 88 Figma MCP Bridge tools →

Write tools on other servers

M-Team MCP Server download_torrent YouTube MCP Server generate_video_title Android Forensics ADB MCP Server combine_reports 0xarchive web3_signup

Go deeper

The MCP Attack Database → Documented attack patterns against MCP deployments — and the policies that stop them.
Argument validation → Checking tool call arguments against schema and policy before they run.
Scoped token → Per-person credentials that grant a defined subset of servers and tools.
Rate Limiting MCP Tool Calls: A Practical Guide →
MCP Security: Why Prompt Guardrails Aren't Enough →

FAQ

Questions about figma_swap_instance

What does the figma_swap_instance tool do? +

Swap a component instance to use a different component. Preserves position and size. It is categorised as a Write tool in the Figma MCP Bridge MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on figma_swap_instance? +

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

What risk level is figma_swap_instance? +

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

Can I rate-limit figma_swap_instance? +

Yes. Add a rate_limit block to the figma_swap_instance 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 figma_swap_instance completely? +

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

figma_swap_instance is provided by the Figma MCP Bridge MCP server (magic-spells/figma-mcp-bridge). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Figma MCP Bridge tool call.

Start from Figma MCP Bridge, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →