figma-design-assets-core-openapi
Core Figma REST API for reading design files, rendering images, listing comments, and posting comments on authorized files. The user supplies a Figma personal access token or OAuth token at connection time; no credential is included. Official documentation: https://developers.figma.com/docs/rest-api/
Connect this API to an AI agent Browse all specs
What you can do with figma-design-assets-core-openapi via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /v1/me |
getFigmaCurrentUser | Get current user |
| GET | /v1/files/{file_key} |
getFigmaFile | Get a Figma file |
| GET | /v1/images/{file_key} |
renderFigmaFileImages | Render file nodes as images |
| GET | /v1/files/{file_key}/comments |
listFigmaComments | List file comments |
| POST | /v1/files/{file_key}/comments |
postFigmaComment | Post a file comment |
Authentication
accessToken
API key — sent as the X-Figma-Token header
Provide a Figma personal access token through the secure connection configuration. OAuth access tokens may be used according to the Figma integration flow.
Usage guide
Getting credentials
- Create or sign in to an account at Figma.
- Create a personal access token or configure an OAuth2 application through the Figma Developer Portal.
- Share the required Figma files with the authorized user or integration.
- When VX Agent asks for authentication, provide the personal access token in the
X-Figma-Tokenheader.
Keep the token private. Do not paste it into the Swagger file, marketplace description, prompts, or chat messages.
How to use this API
Use this API to inspect authorized design files, render selected nodes as images, read file comments, and post comments to Figma files.
A typical workflow is:
- Use
GET /v1/meto verify the connected Figma user. - Use
GET /v1/files/{file_key}to read the JSON structure and metadata of an authorized file. - Use
GET /v1/images/{file_key}with selected node IDs to render frames or components as PNG, JPG, SVG, or PDF. - Use
GET /v1/files/{file_key}/commentsto review existing comments. - Use
POST /v1/files/{file_key}/commentsonly after confirming the exact file and final comment text.
The file_key is the identifier in the Figma file URL. Start with specific node IDs and avoid requesting an entire large file when only a few components are needed.
Safety and usage notes
Only access files that the user or integration is authorized to access. Treat designs, comments, user information, and exported assets as potentially confidential. Require confirmation before posting comments to collaborators.
Official documentation: Figma REST API.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “figma-design-assets-core-openapi” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.