Figma

Posts a new comment to a figma file or branch, optionally replying to an existing root comment (replies cannot be nested); `region height` and `region width` in `client meta` must be positive if defining a comment region.

Posts a specified emoji reaction to an existing comment in a figma file or branch, requiring valid file key and comment id.

Creates a figma webhook for a `team id` to send post notifications for an `event type` to a publicly accessible https `endpoint`; an initial ping is sent unless `status` is `paused`.

Creates and attaches multiple uniquely-urled development resources to specified figma nodes, up to 10 per node.

Manages variables, collections, modes, and their values in a figma file via batch create/update/delete operations; use temporary ids to link new related items in one request and ensure `variablemodevalues` match the target variable's `resolvedtype`.

Deletes a specific comment from a figma file or branch, provided the authenticated user is the original author of the comment.

Deletes a specific emoji reaction from a comment in a figma file; the user must have originally created the reaction.

Permanently deletes an existing webhook, identified by its unique `webhook id`; this operation is irreversible.

Deletes a development resource (used to link figma design elements to external developer information like code or tasks) from a specified figma file.

Detect background layers for selected nodes. uses geometric analysis, z-index ordering, and visual properties to identify potential background layers.

🔍 smart figma resource discovery - never guess ids again! 🎯 easiest method: just paste any figma url to get all ids: • file urls: https://www.figma.com/file/abc123/design → get file key • design urls: https://www.figma.com/design/abc123/design → get file key • node urls: ...?node-id=123:456 → get file key + node id • team urls: .../team/123456/... → get team id 🔄 step-by-step discovery: 1. team id → projects list (with project ids) 2. project id → files list (with file keys + thumbnails) 3. file key → nodes list (with node ids + hierarchy) 💡 common workflows: • extract from url: discoverfigmaresources(figma url="...") • browse team: discoverfigmaresources(team id="123") • list files: discoverfigmaresources(project id="proj 456") • find nodes: discoverfigmaresources(file key="abc123") ✨ get file key for getfilejson, node ids for detectbackground, etc.

Download images from figma file nodes. renders specified nodes as images and downloads them using mercury's filedownloadable infrastructure. supports png, svg, jpg, and pdf formats.

Extract design tokens from figma files. combines styles, variables, and extracted values to create a comprehensive design token system.

Extract prototype interactions and animations from figma files. analyzes the prototype data to extract: - user interactions (clicks, hovers, etc.) - transition animations - component variant states - user flows and navigation

Retrieves activity log events from figma, allowing filtering by event types, time range, and pagination.

Retrieves detailed information about a specific webhook by its id, provided the webhook exists and is accessible to the user.

Retrieves all comments from an existing figma file, identified by a valid `file key`, returning details like content, author, position, and reactions, with an option for markdown formatted content.

Get component data with automatic simplification. returns clean, ai-friendly component structure.

Retrieves detailed metadata for a specific published figma component set using its unique `key`.

Retrieves detailed information for the currently authenticated figma user.

Retrieves development resources (e.g., jira/github links) for a figma main file, optionally filtering by specific node ids.

Fetches a list of files in a figma project, optionally including branch metadata.

Retrieves published components from a figma file, which must be a main file (not a branch) acting as a library.

Retrieves all published component sets from the specified figma main file (file key must not be for a branch).

Get figma file data with automatic simplification. this enhanced version automatically transforms verbose figma json into clean, ai-friendly format with: - css-like property names - deduplicated variables - removed empty values - 70%+ size reduction use simplify=false to get raw api response.

Retrieves a list of published styles (like colors, text attributes, effects, and layout grids) from a specified main figma file (not a branch).

Retrieves temporary (14-day expiry) download urls for all image fills in a figma file; requires `imageref` from `paint` objects to map urls.

Retrieves component insertion and detachment analytics for a specified figma library, groupable by 'component' or 'team' and filterable by a date range (yyyy-mm-dd).

Retrieves component usage analytics for a specified figma library file (identified by `file key`), with data groupable by 'component' or 'file'.

Retrieves style usage analytics (insertions, detachments) for a figma library, grouped by 'style' or 'team'; if providing a date range, ensure end date is not before start date.

Retrieves style usage analytics for a figma library (specified by a valid `file key`), allowing data to be grouped by 'file' or 'style'.

Retrieves weekly, paginated analytics data on variable insertions and detachments for a specified figma library (identified by `file key`), groupable by 'variable' or 'team', and filterable by an optional date range.

Retrieves paginated analytics data on variable usage from a specified figma library, grouped by 'file' or 'variable', for libraries with enabled analytics.

Retrieves all local/remote variables for a figma file/branch; crucial for obtaining mode-specific values which `/v1/files/{file key}/variables/published` omits.

Deprecated: use 'get current user' instead. retrieves user information for the authenticated user.

Retrieves a user's payment information for a figma plugin, widget, or community file; the authenticated identity must own the resource.

Retrieves projects within a specified figma team that are visible to the authenticated user.

Retrieves variables published from a specified figma file; this api is available only to full members of enterprise organizations.

Retrieves reactions for a specific comment in a figma file.

Retrieves detailed metadata for a specific style in figma using its unique style key.

Retrieves components published in a specific figma team's library; the team must have published components, otherwise an empty list is returned.

Retrieves a paginated list of published component sets (collections of reusable ui elements) from a specified figma team's library.

Retrieves a paginated list of published styles, such as colors or text attributes, from a specified figma team's library.

Retrieves all webhooks registered for a specified figma team.

Retrieves the version history for a figma file or branch, as specified by its `file key`.

Retrieves a history of webhook requests for a specific figma webhook subscription; data is available for requests sent within the last seven days.

Renders specified nodes from a figma file as images (jpg, pdf, png, svg), returning a map of node ids to image urls (or `null` for failed nodes); images expire after 30 days and are capped at 32 megapixels (larger requests are scaled down).

Updates an existing figma webhook, identified by `webhook id`, allowing modification of its event type, endpoint, passcode, status, or description.

Updates the name and/or url of one or more existing figma dev resources, each identified by its unique `id`.