Figma

Design files. Read a file, its components and styles, export images, comment on a design, and watch a team's libraries.

Measured routing accuracy

57 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 45 cases written by hand and 12 cases from the paraphrase pass. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

4 of the 49 action tools listed above are declared uncallable, so they are indexed nowhere and answer none of these cases. The counts here are scored over the other 45.

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

oauth2

api_key

Submit the key with ConnectionsService rather than putting it in a request; it is sealed at rest and never returned.

Tools

49 action tools. The catalog-wide slug is figma.<tool>, which is what search_tools returns and call_tool takes.

figma.get_activity_logs

Get activity logs. Returns a list of activity log events. Calls GET /v1/activity_logs.

Class read (reads only). Scopes org:activity_log_read. Calls GET /v1/activity_logs.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who did what in our figma org", "audit trail of account events", "history of admin changes on the plan".

figma.get_ai_usage_daily

Get daily AI credit usage. Returns per-user, per-day AI credit usage for the plan associated with the calling token. Calls GET /v1/ai_usage/daily.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /v1/ai_usage/daily.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "how many ai credits did people burn", "per person ai spend by day", "daily consumption of the plan's ai allowance".

figma.get_library_analytics_component_actions

Figma library analytics for component actions: how often people inserted or detached the components a library publishes, broken down by team or week. Calls GET /v1/analytics/libraries/{file_key}/component/actions.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/component/actions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "how often are our components inserted", "who is using the design system components", "component insert and detach counts by team".

figma.get_library_analytics_component_usages

Figma library analytics for component usage: which files use the components a library publishes, and how many places each one appears in. Calls GET /v1/analytics/libraries/{file_key}/component/usages.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/component/usages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which files use our design system components", "where is this component actually used", "count the places a library symbol appears".

figma.get_library_analytics_style_actions

Figma library analytics for style actions: how often people applied or detached the colour and text styles a library publishes, broken down by team or week. Calls GET /v1/analytics/libraries/{file_key}/style/actions.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/style/actions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "how often are our shared styles applied", "colour and text style adoption over time", "is anyone detaching the library styles".

figma.get_library_analytics_style_usages

Figma library analytics for style usage: which files use the colour and text styles a library publishes, and how many places each one appears in. Calls GET /v1/analytics/libraries/{file_key}/style/usages.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/style/usages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which files use our shared colour styles", "where is a text style actually used", "count the places a library style appears".

figma.get_library_analytics_variable_actions

Figma library analytics for variable actions: how often people applied or detached the design tokens a library publishes, broken down by team or week. Calls GET /v1/analytics/libraries/{file_key}/variable/actions.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/variable/actions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "how often are our design tokens applied", "token adoption across the org over time", "is anyone detaching the shared variables".

figma.get_library_analytics_variable_usages

Figma library analytics for variable usage: which files use the design tokens a library publishes, and how many places each one appears in. Calls GET /v1/analytics/libraries/{file_key}/variable/usages.

Class read (reads only). Scopes library_analytics:read. Calls GET /v1/analytics/libraries/{{params.file_key}}/variable/usages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which files use our design tokens", "where is a shared variable actually used", "count the places a token appears".

figma.get_component_set

Get one published Figma component set by its key: the variant group's metadata, which library it came from, and when it was published. Calls GET /v1/component_sets/{key}.

Class read (reads only). Scopes files:read, library_assets:read. Calls GET /v1/component_sets/{{params.key}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look up a published variant group", "what library does this component set come from", "metadata for one set of component variants".

figma.get_component

Get one published Figma component by its key: the symbol's metadata, which library published it, and when. Calls GET /v1/components/{key}.

Class read (reads only). Scopes files:read, library_assets:read. Calls GET /v1/components/{{params.key}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look up a published symbol by its key", "which library published this component", "metadata for one reusable element".

figma.post_dev_resources

Attach dev resources to Figma nodes: link specs, tickets, or repository URLs onto layers in bulk so engineers find them on the design. Calls POST /v1/dev_resources.

Class write (writes, no confirmation needed). Scopes file_dev_resources:write. Calls POST /v1/dev_resources.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "link a ticket to a design layer", "attach github urls onto frames for engineers", "add developer links across several files".

figma.put_dev_resources

Update dev resources on Figma nodes: change the names or URLs of links already attached to layers, in bulk. Calls PUT /v1/dev_resources.

Class write (writes, no confirmation needed). Scopes file_dev_resources:write. Calls PUT /v1/dev_resources.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "fix a broken link attached to a layer", "rename the developer links on a design", "point an attached ticket at a new url".

figma.get_developer_logs

Get developer logs. Returns a list of developer log entries for REST API and MCP server requests made within the organization. Calls POST /v1/developer_logs.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /v1/developer_logs.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "recent api calls our integration made", "what requests hit the rest api", "troubleshoot our mcp server traffic".

figma.get_file

Read a Figma design document: its whole node tree, layers, frames, and pages. Use when someone asks for the contents or the structure of a file or mockup. Calls GET /v1/files/{file_key}.

Class read (reads only). Scopes file_content:read, files:read. Calls GET /v1/files/{{params.file_key}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull the full contents of a design", "read the layers and frames of a mockup", "fetch the whole document tree".

figma.get_comments

List the comments left on a Figma file: the feedback, review notes, and replies people wrote on a design or mockup. Use when someone asks what was said about a document. Calls GET /v1/files/{file_key}/comments.

Class read (reads only). Scopes file_comments:read, files:read. Calls GET /v1/files/{{params.file_key}}/comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "see the feedback left on a design", "read the notes people wrote on a mockup", "who said what on this document".

figma.post_comment

Leave a comment on a Figma file: feedback, a review note, or a reply for the designer on a mockup. Use when someone wants to write a note on a design. Calls POST /v1/files/{file_key}/comments.

Class write (writes, no confirmation needed). Scopes file_comments:write. Calls POST /v1/files/{{params.file_key}}/comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "leave feedback on a mockup", "write a note for the designer", "reply on the design with a suggestion".

figma.delete_comment

Delete a comment on a Figma file: remove a piece of feedback or a review note someone left on a design. Calls DELETE /v1/files/{file_key}/comments/{comment_id}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes file_comments:write. Calls DELETE /v1/files/{{params.file_key}}/comments/{{params.comment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "remove feedback left on a design", "take a review note off a mockup", "clear a resolved remark from a file".

figma.get_comment_reactions

List the reactions on a Figma comment: the emoji people left on one piece of feedback, and who left them. Calls GET /v1/files/{file_key}/comments/{comment_id}/reactions.

Class read (reads only). Scopes file_comments:read, files:read. Calls GET /v1/files/{{params.file_key}}/comments/{{params.comment_id}}/reactions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who reacted to this piece of feedback", "show the emoji left on a comment", "see the thumbs up on a review note".

figma.post_comment_reaction

React to a Figma comment: leave an emoji on someone's feedback to acknowledge or agree with it. Calls POST /v1/files/{file_key}/comments/{comment_id}/reactions.

Class write (writes, no confirmation needed). Scopes file_comments:write. Calls POST /v1/files/{{params.file_key}}/comments/{{params.comment_id}}/reactions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "leave an emoji on someone's feedback", "thumbs up a review note", "acknowledge a comment with a reaction".

figma.delete_comment_reaction

Remove a reaction from a Figma comment: take back the emoji left on a piece of feedback. Calls DELETE /v1/files/{file_key}/comments/{comment_id}/reactions.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes file_comments:write. Calls DELETE /v1/files/{{params.file_key}}/comments/{{params.comment_id}}/reactions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "take back an emoji from a comment", "undo my reaction on some feedback", "remove a thumbs up from a review note".

figma.get_file_component_sets

List the component sets a Figma file publishes: the variant groups defined in that library, with their names and keys. Calls GET /v1/files/{file_key}/component_sets.

Class read (reads only). Scopes files:read, library_content:read. Calls GET /v1/files/{{params.file_key}}/component_sets.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what variant groups does this library publish", "list the component sets defined in a file", "show the variants available from a design library".

figma.get_file_components

List the components a Figma file defines: the reusable symbols, building blocks, and elements published from that document. Calls GET /v1/files/{file_key}/components.

Class read (reads only). Scopes files:read, library_content:read. Calls GET /v1/files/{{params.file_key}}/components.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "list the symbols inside a mockup", "browse the building blocks of a design", "which reusable pieces does this document have".

figma.get_dev_resources

List the dev resources attached to a Figma file: the specs, tickets, and repository links engineers put on its layers. Calls GET /v1/files/{file_key}/dev_resources.

Class read (reads only). Scopes file_dev_resources:read. Calls GET /v1/files/{{params.file_key}}/dev_resources.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what tickets are linked to this design", "show the engineering links on a file", "find the repo urls attached to layers".

figma.get_image_fills

Get download links for the images placed inside a Figma file: the photos and bitmaps used as fills on its layers. Calls GET /v1/files/{file_key}/images.

Class read (reads only). Scopes file_content:read, files:read. Calls GET /v1/files/{{params.file_key}}/images.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "download the photos placed in a design", "links to the bitmaps used as fills", "get the raw images inside a file".

figma.get_file_meta

Get a Figma file's metadata: its name, owner, last edit time, and which project it sits in, without loading the document itself. Calls GET /v1/files/{file_key}/meta.

Class read (reads only). Scopes file_metadata:read, files:read. Calls GET /v1/files/{{params.file_key}}/meta.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who owns this design and when was it edited", "basic details about a file without opening it", "what project does a mockup live in".

figma.get_file_nodes

Get specific nodes of a Figma file as JSON: just the frames or layers named by id, instead of the whole document. Calls GET /v1/files/{file_key}/nodes.

Class read (reads only). Scopes file_content:read, files:read. Calls GET /v1/files/{{params.file_key}}/nodes.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "read just one frame of a design", "fetch a couple of layers by id", "pull part of a document instead of all of it".

figma.get_file_styles

List the styles a Figma file publishes: the colour, text, and effect styles defined in that library. Calls GET /v1/files/{file_key}/styles.

Class read (reads only). Scopes files:read, library_content:read. Calls GET /v1/files/{{params.file_key}}/styles.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what colour styles does this library publish", "list the text styles defined in a file", "show the shared effects a design exposes".

figma.post_variables

Create, change, or delete Figma variables in a file: bulk edit the design tokens and their collections in one call. Enterprise editors only. Calls POST /v1/files/{file_key}/variables.

Class write (writes, no confirmation needed). Scopes file_variables:write. Calls POST /v1/files/{{params.file_key}}/variables.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "bulk edit the design tokens in a file", "add a collection of variables at once", "change token values across a document".

figma.get_local_variables

List the variables defined inside a Figma file: the design tokens and their values for colour, spacing, and text. Calls GET /v1/files/{file_key}/variables/local.

Class read (reads only). Scopes file_variables:read. Calls GET /v1/files/{{params.file_key}}/variables/local.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what tokens does a mockup define", "list the design tokens of a document", "browse the token values in this design".

figma.get_published_variables

List the variables a Figma file publishes: the design tokens other files can subscribe to from this library. Enterprise members only. Calls GET /v1/files/{file_key}/variables/published.

Class read (reads only). Scopes file_variables:read. Calls GET /v1/files/{{params.file_key}}/variables/published.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what design tokens does this library expose", "which variables can other files subscribe to", "list the published token collections".

figma.get_file_versions

List a Figma file's version history: the past snapshots of a design, what changed and when, and who edited it. Calls GET /v1/files/{file_key}/versions.

Class read (reads only). Scopes file_versions:read, files:read. Calls GET /v1/files/{{params.file_key}}/versions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what changed and when on this document", "list past snapshots of a mockup", "who edited this design and when".

figma.get_images

Render frames or nodes of a Figma file as images: export a picture, png, svg, or pdf of a design. Use for thumbnails and screenshots of artboards. Calls GET /v1/images/{file_key}.

Class read (reads only). Scopes file_content:read, files:read. Calls GET /v1/images/{{params.file_key}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "export frames as png or svg", "render a picture of a node", "make thumbnails of the artboards".

figma.get_me

Show the signed-in Figma user: the account whose token is connected, with name, email, and profile image. Use for who-am-I questions and to check which account is in use. Calls GET /v1/me.

Class read (reads only). Scopes current_user:read, files:read. Calls GET /v1/me.

Takes no arguments.

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which account is connected", "who am i on this workspace", "show my own profile details".

figma.get_o_embed

Get oEmbed data for a Figma link: the title, thumbnail, and embed HTML another site needs to render a preview card of a file. Calls GET /v1/oembed.

Class read (reads only). Scopes file_metadata:read. Calls GET /v1/oembed.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "preview card data for a figma link", "title and thumbnail for embedding a design", "what a site needs to render a figma url".

figma.get_payments

Get payments. There are two methods to query for a user's payment information on a plugin, widget, or Community file. Calls GET /v1/payments.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /v1/payments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look up payments", "check payments", "pull up payments".

figma.get_project_files

List the files in a Figma project: every document in that folder, with names and last-modified times. Calls GET /v1/projects/{project_id}/files.

Class read (reads only). Scopes files:read, projects:read. Calls GET /v1/projects/{{params.project_id}}/files.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what designs live in this folder", "list every document in a project", "show the mockups a team keeps together".

figma.get_project_meta

Get a Figma project's metadata: the folder's name and the team it belongs to. Calls GET /v1/projects/{project_id}/meta.

Class read (reads only). Scopes project_metadata:read. Calls GET /v1/projects/{{params.project_id}}/meta.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which team owns this folder", "name and owner of a design project", "basic details about a figma folder".

figma.get_style

Get one published Figma style by its key: the colour, text, or effect definition and which library it came from. Calls GET /v1/styles/{key}.

Class read (reads only). Scopes files:read, library_assets:read. Calls GET /v1/styles/{{params.key}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look up a published colour definition", "which library does this text style come from", "details of one shared effect".

figma.get_team_component_sets

List the component sets a Figma team publishes: the variant groups across every library the team owns. Calls GET /v1/teams/{team_id}/component_sets.

Class read (reads only). Scopes files:read, team_library_content:read. Calls GET /v1/teams/{{params.team_id}}/component_sets.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what variant groups does the team publish", "component sets across all our libraries", "variants available to everyone on a team".

figma.get_team_components

List the components a Figma team publishes: the reusable symbols across every library the team owns. Calls GET /v1/teams/{team_id}/components.

Class read (reads only). Scopes files:read, team_library_content:read. Calls GET /v1/teams/{{params.team_id}}/components.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what symbols does the whole team publish", "reusable elements across all our libraries", "components available to everyone on a team".

figma.get_team_projects

List the projects a Figma team owns: the work a group tracks in its workspace. Use when someone asks what a team or group is working on. Calls GET /v1/teams/{team_id}/projects.

Class read (reads only). Scopes files:read, projects:read. Calls GET /v1/teams/{{params.team_id}}/projects.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what is my group working on", "browse the work a group owns", "list the boards my group keeps".

figma.get_team_styles

List a Figma team's published styles: the shared colour, text, and effect presets a group publishes for reuse. Calls GET /v1/teams/{team_id}/styles.

Class read (reads only). Scopes files:read, team_library_content:read. Calls GET /v1/teams/{{params.team_id}}/styles.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which shared colour and text presets exist", "browse the presets my group publishes", "list reusable colour definitions".

figma.get_team_webhooks

List the webhooks registered on a Figma team, through the deprecated team-scoped endpoint: the event callbacks that team set up. Calls GET /v2/teams/{team_id}/webhooks.

Class read (reads only). Scopes files:read, webhooks:read. Calls GET /v2/teams/{{params.team_id}}/webhooks.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what event callbacks does this team have", "webhooks registered under one team, old endpoint", "list a team's subscriptions the deprecated way".

figma.get_webhooks

List Figma webhooks by context: the event callbacks registered for a team, project, or file, and where each one posts. Calls GET /v2/webhooks.

Class read (reads only). Scopes webhooks:read. Calls GET /v2/webhooks.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what event callbacks are registered for us", "where do design updates get posted", "list every subscription in this context".

figma.post_webhook

Create a Figma webhook: notify a server or an endpoint when a design changes, subscribing it to file update events. Calls POST /v2/webhooks.

Class write (writes, no confirmation needed). Scopes webhooks:write. Calls POST /v2/webhooks.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "notify my server when a design changes", "subscribe an endpoint to design events", "set up a callback for document updates".

figma.get_webhook

Get one Figma webhook by id: what it subscribes to, where it posts, and whether it is active. Calls GET /v2/webhooks/{webhook_id}.

Class read (reads only). Scopes files:read, webhooks:read. Calls GET /v2/webhooks/{{params.webhook_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what does this callback subscribe to", "is a single subscription still active", "where does one webhook post its events".

figma.put_webhook

Update a Figma webhook: change the endpoint it posts to, the events it listens for, or its active state. Calls PUT /v2/webhooks/{webhook_id}.

Class write (writes, no confirmation needed). Scopes webhooks:write. Calls PUT /v2/webhooks/{{params.webhook_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "point a callback at a new endpoint", "change which events a subscription listens for", "pause or reactivate a webhook".

figma.delete_webhook

Delete a Figma webhook: stop the event callbacks and notifications going to an endpoint, unsubscribing a server from design updates. Calls DELETE /v2/webhooks/{webhook_id}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes webhooks:write. Calls DELETE /v2/webhooks/{{params.webhook_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "stop event callbacks going to my endpoint", "turn off notifications for a design", "unsubscribe my server from updates".

figma.get_webhook_requests

List a Figma webhook's recent deliveries: the calls it made in the last week and how the receiving endpoint responded, for debugging. Calls GET /v2/webhooks/{webhook_id}/requests.

Class read (reads only). Scopes files:read, webhooks:read. Calls GET /v2/webhooks/{{params.webhook_id}}/requests.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "did our endpoint receive the last events", "why is a callback failing to deliver", "recent delivery attempts and their responses".