LOCAL TOOL — Starts interactive one-click OAuth authorization with Figma. Do what: Launches the user's default browser automatically to approve Figma Remote MCP connection, and returns a clickable Markdown URL directly in the chat interface. Expected output: JSON containing { auth_url, markdown_link, instructions } so the user can click directly or let the opened browser complete login. Use this whenever authentication is missing, expired, or when the user wants to connect their Figma account.

LOCAL TOOL — Checks current Figma authentication status. Do what: Inspects active access tokens, user seat, expiry time, and secure storage location. Expected output: JSON containing { authenticated, user, email, expires_at, is_expired, storage_path }.

LOCAL TOOL — Call this FIRST before any other Figma tool when the user has not explicitly provided a Figma URL or fileKey. Do what: Detects which Figma file the user currently has open in Figma desktop app, returning fileKey, nodeId, and instructions. Expected output: JSON with { authentication, figma_desktop_open_file: { fileKey, fileName, nodeId, url }, instructions[] }.

Do what: Returns the authenticated user identity (handle, email), all plans/teams, and available seats. Expected output: { handle, email, plans: [{ name, key, role, seat }] }. MUST call this if experiencing permission errors or before calling create_new_file to resolve planKey.

Do what: Returns XML document outline for a Figma design file — node IDs, layer names, types, positions, sizes. Expected output: XML string of the document tree rooted at nodeId (or list of pages when nodeId is omitted). Use this to explore unfamiliar files before calling get_design_context. Prefer get_design_context for design-to-code. IMPORTANT: Only works on /design/ files. When nodeId is omitted, lists top-level pages only.

Do what: Primary READ tool for design-to-code. Returns layout, styles, component props, reference code snippet, screenshot, and asset URLs for a node. Expected output: { code (string), screenshot (URL), assets (map of download URLs), metadata }. Always prefer this over get_metadata for design inspection. Call figma_get_current_context first if you do not know the fileKey. IMPORTANT: nodeId is REQUIRED — extract from URL ?node-id=1-2 as "1:2". Never guess or pass empty.

Do what: Returns all design variables (tokens) referenced by a node — colors, spacing, typography values with their names and resolved values. Expected output: Map of variable names to resolved values e.g. { "p1-orange": "#ED9E4A" }. Use to extract the design system token palette before writing code or creating new nodes.

Do what: Renders a PNG screenshot of any node and returns a short-lived CDN URL + curl download command. Expected output: { url (string CDN URL), curl (string), metadata: { width, height, original_width, original_height } }. IMPORTANT: Both fileKey and nodeId are REQUIRED.

Do what: Downloads rendered exports and raw source images/SVGs for a single node. Expected output: { export: { url, format }, rawImages: [{ url, format }], svgAssets: [{ url }] }. Use when: you need the rendered PNG/SVG/PDF of a node, or want to extract embedded raster fills for cross-file transfer.

Do what: Uploads images (PNG, JPG, GIF, WebP) or SVGs into a Figma file. Returns single-use upload URLs. POST raw bytes to each returned URL. Expected output: { uploads: [{ uploadUrl, targetNodeId?, commitUrl? }] }.

Do what: PRIMARY WRITE TOOL. Executes arbitrary JavaScript against the Figma Plugin API sandbox to create, edit, delete, or query any design element. Expected output: Return value of the executed code (JSON-serializable). Mutations are applied live to the Figma canvas. CRITICAL RULES:

• Parameters: fileKey (required), code (required JS string), description (required human-readable intent).

• code has access to the global figma object (Figma Plugin API).

• MUST use await figma.setCurrentPageAsync(page) to switch pages.

• NEVER use: loadAllPagesAsync, setPluginData, createImageAsync.

• Font style for Inter: "Semi Bold" (not "SemiBold"), "Extra Bold" (not "ExtraBold").

Do what: Creates a new blank Figma design, FigJam, or Slides file in the user's drafts (or a specified project). Expected output: { fileKey (string), url (string) } — the new file's key and direct URL. IMPORTANT: Requires planKey from whoami. Do NOT call if the user already has a file open — use use_figma instead.

Do what: Creates a flowchart, sequence diagram, state diagram, gantt chart, or ER diagram in FigJam from Mermaid.js syntax. Expected output: { url (string) } — direct URL to the created FigJam diagram. MUST show this URL as a markdown link.