{"id":15110,"library":"figma-developer-mcp","title":"Framelink MCP for Figma","description":"Figma Developer MCP (Model Context Protocol) is a Node.js server designed to bridge Figma design data with AI-powered coding agents, such as Cursor. Currently at version 0.11.0, the package sees a rapid release cadence, often with multiple updates within a month, indicating active development. Its core function is to fetch relevant metadata from the Figma API, then simplify and translate this data into a format optimized for AI models, focusing on layout and styling information. This targeted data reduction helps AI agents accurately \"one-shot\" designs into various frameworks, improving their precision compared to alternative methods like screenshot analysis. It differentiates itself by acting as a specialized intermediary, reducing context overload for AI models and facilitating direct integration of design specifications into code generation workflows via the Model Context Protocol.","status":"active","version":"0.11.0","language":"javascript","source_language":"en","source_url":"https://github.com/GLips/Figma-Context-MCP","tags":["javascript","figma","mcp","typescript"],"install":[{"cmd":"npm install figma-developer-mcp","lang":"bash","label":"npm"},{"cmd":"yarn add figma-developer-mcp","lang":"bash","label":"yarn"},{"cmd":"pnpm add figma-developer-mcp","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required runtime environment, specified as '>=20.20.0' in package.json engines.","package":"node","optional":false},{"reason":"Commonly used to run the server executable without global installation, as shown in quickstart.","package":"npx","optional":true}],"imports":[{"note":"This package is primarily a command-line tool and server. Direct programmatic imports (e.g., `import { ... } from 'pkg'`) are not its typical use case. It is usually invoked via `npx` or a direct executable call within an AI client's configuration.","symbol":"Figma Developer MCP Server","correct":"npx figma-developer-mcp --figma-api-key=YOUR-KEY --stdio"},{"note":"The command for running the server on Windows often requires `cmd /c` to correctly execute `npx`.","symbol":"Figma Developer MCP Server (Windows)","correct":"cmd /c npx -y figma-developer-mcp --figma-api-key=YOUR-KEY --stdio"}],"quickstart":{"code":"{  \"mcpServers\": {    \"Framelink MCP for Figma\": {      \"command\": \"npx\",      \"args\": [\"-y\", \"figma-developer-mcp\", \"--figma-api-key=YOUR-KEY\", \"--stdio\"],      \"env\": { \"FIGMA_API_KEY\": \"YOUR-KEY\" }    }  }}","lang":"json","description":"This configuration JSON snippet demonstrates how to set up Framelink MCP for Figma within an AI client that supports Model Context Protocol servers, such as Cursor. It specifies the command to run the server and passes the Figma API key."},"warnings":[{"fix":"Review any custom server configurations or integrations for compatibility. The new stateless approach might require changes in how state is managed externally if needed.","message":"The server's internal HTTP transport mechanism was switched to a stateless model. This could impact custom integrations or configurations that relied on the previous stateful behavior.","severity":"breaking","affected_versions":">=0.8.0"},{"fix":"If you are programmatically interacting with `getServerConfig()`, update your calls to remove the `isStdioMode` parameter and retrieve stdio mode from the returned `ServerConfig` object instead.","message":"The `getServerConfig()` function signature changed. It no longer accepts an `isStdioMode` parameter; it now internally detects stdio mode and returns it as part of the `ServerConfig` object.","severity":"breaking","affected_versions":">=0.7.0"},{"fix":"Review the project's documentation or GitHub repository for information on how to opt-out of telemetry if privacy is a concern.","message":"Anonymous PostHog telemetry was added, which collects usage data. Users should be aware of this data collection. There is no explicit mention of an opt-out mechanism in the provided changelog.","severity":"gotcha","affected_versions":">=0.10.0"},{"fix":"If your environment relies on HTTP proxy auto-detection via environment variables (like `HTTP_PROXY`), verify that network requests from `figma-developer-mcp` are still routed correctly or reconfigure explicit proxy settings if necessary.","message":"The default behavior for routing traffic through `EnvHttpProxyAgent` was changed. Previously, all traffic was routed, but this was stopped in version 0.11.0.","severity":"gotcha","affected_versions":">=0.11.0"},{"fix":"Ensure your Node.js environment is updated to version `20.20.0` or newer to run this package.","message":"The package now enforces Node.js version `20.20.0` or higher. Older Node.js versions are not supported and will prevent the server from running.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Ensure the `FIGMA_API_KEY` is correctly set in your AI client's configuration or as an environment variable, and that it's a valid personal access token with appropriate permissions. Check the Figma help documentation for creating and managing tokens.","cause":"The Figma API key is either missing, incorrect, or does not have sufficient permissions to access the specified Figma file.","error":"403 Forbidden: Missing Figma API Key"},{"fix":"Verify that the Figma link points to a valid and accessible node within the file. The node might have been deleted, moved, or the link itself is malformed.","cause":"The specific Figma node (frame, group, component) referenced by its ID could not be found within the provided Figma file URL.","error":"Error: Node not found with ID '...' in Figma file '...'"},{"fix":"Carefully review your AI client's MCP server configuration JSON against the provided quickstart example, ensuring all necessary fields are present and correctly formatted, especially `command` and `args`.","cause":"The AI client's configuration for the MCP server is incomplete or malformed, missing required fields like `command` or `args`.","error":"mcpServers configuration error: 'command' or 'args' not found"}],"ecosystem":"npm"}