Design Context Bridge

design-context-bridge is an MCP server that turns any AI agent into a frontend developer who can actually read a Figma file — not guess from a screenshot. When you hand a developer a Figma and say "build this", they don't just copy the visible pixels. They open the file, identify the components, read the exact colors and type scale, infer the routes the app will need, figure out the hover and disabled states, and export the icons. This server gives the AI that same access, so it can do that work for you — faithfully, not approximately

GitHub

Documentation

Design Context Bridge

Design Context Bridge — an independent MCP server that connects Figma design context to AI coding agents. Not affiliated with Figma.

npm i -g design-context-bridge · An independent MCP server for Figma

npm MIT Node ≥ 18 20 tools CI

What is this?

design-context-bridge is an MCP server that turns any AI agent into a frontend developer who can actually read a Figma file — not guess from a screenshot.

When you hand a developer a Figma and say "build this", they don't just copy the visible pixels. They open the file, identify the components, read the exact colors and type scale, infer the routes the app will need, figure out the hover and disabled states, and export the icons. This server gives the AI that same access, so it can do that work for you — faithfully, not approximately.

Who is it for?

  • Frontend developers who get a Figma and need to build it pixel-faithful, fast.
  • Designers and PMs who want an AI to reason about a design — routes, components, tokens — without writing code.
  • Anyone building AI tooling that needs structured, reliable design data instead of vision-model guesswork.

Why not just paste a screenshot?

A screenshot is a guess. This is the real data.

Pasting a screenshotdesign-context-bridge
AI guesses colors from pixelsReads the exact hex, per layer
Approximate spacing and sizesReal auto-layout gaps, padding, geometry
No idea what's a reusable componentIdentifies components and their variants
Invents hover/disabled statesReads the actual prototype interactions
You export icons by handfind_assets + export_image build the folder
Can't see tokensDerives a full design system, even without Figma Variables

Two ways to connect

Everything works in both modes — choose by workflow, or use both at once.

🔌 Plugin mode

A Figma plugin ("Frontend Handoff Snapshot") runs inside Figma desktop. Select any layer and instantly see its colors, typography, and spacing in the plugin panel — no token or server needed for inspection. When you're ready, press Export to send the full selection context to the local bridge for your AI coding tool.

The plugin only talks to localhost and never modifies your file. It is not Figma's official MCP integration (use_figma) and isn't a replacement for it — pairing it with the MCP server below is optional, for developers who want their AI coding tool to read that same exported context.

→ Figma Community plugin (pending review) · Plugin setup

🌐 REST API mode

Pass any figma.com URL and the server reads it through the Figma REST API with a personal access token. No plugin, no Figma desktop, no selection. Best for reviewing files you don't have open, CI, or headless use.

→ REST API setup

The design-system, structure, variant and asset-export tools run in REST mode — pass a URL and they read the whole file.

Quick start

npx design-context-bridge

Add it to your AI client, then ask in plain language:

"Extract the design system from this Figma: <url>"
"What routes would this app have?"
"What variants does this Button component have?"
"Export every icon in this file as SVG into ./assets"
"Build this landing page faithfully — components, tokens, hover states and all."

The AI calls the right tools, gets real data, and builds from it.

What it can do

CapabilityToolsHow you'd ask
Read the live selectionget_current_selection, get_selected_colors, get_selected_texts, get_selected_spacing, get_selected_interactions"What colors are in my selection?"
Navigate any fileget_all_pages, get_current_page, get_frame_by_name, get_node_info, get_nodes_info, scan_nodes_by_types"Find the Checkout frame and show its tree"
Derive a design systemextract_design_system, get_variables, get_component_definitions"Give me the tokens: colors, type scale, spacing"
Plan the buildanalyze_structure, get_component_variants"What routes and components does this need?"
Export assetsfind_assets, export_image"Export all icons as SVG"
Start from a URLget_file_from_url, get_node_from_url"Read this Figma link"

→ Full reference with every argument in docs/tools.md

How it works

Figma desktop              design-context-bridge            AI agent
──────────────    HTTP     ─────────────────   stdio   ──────────
  Plugin        ────────►  :3055 bridge     ◄────────  Claude Code
  (push/poll)              + MCP server                Cursor
                                                       OpenCode
              figma.com    ─────────────────           Windsurf
  Any file URL ────────►  REST API client              VS Code…
  1. The plugin pushes selection context and answers on-demand node requests in real time.
  2. The MCP server exposes 20 tools over stdio.
  3. The REST client reads any file from api.figma.com when FIGMA_ACCESS_TOKEN is set — and powers the analysis and asset tools.

Documentation

GuideWhat it covers
Plugin setupInstall the Figma plugin, verify the bridge, configure the port
REST API setupGenerate a Figma token, add it to your client config
Client configurationClaude Code · Claude Desktop · Cursor · OpenCode · Windsurf · VS Code
Tools referenceAll 20 tools — arguments, return values, and usage patterns

Token handling

Your FIGMA_ACCESS_TOKEN is read only from the environment and sent only to api.figma.com in the X-Figma-Token header. It is never logged, cached, or written to disk by this server, and never included in tool responses. Treat it like a password: use a scoped Personal Access Token, never commit it, and revoke it if exposed. PATs are intended for local/single-user use — for a public, multi-user product, use Figma OAuth instead.

Security & privacy

  • The local bridge listens on 127.0.0.1:3055 only — never expose it to untrusted networks.
  • This tool runs entirely on your machine; its maintainers receive no data.
  • Design data is relayed to the AI client you connect, which may forward it to its model provider.
  • Only use it with Figma files you have permission to access.

See SECURITY.md and PRIVACY.md for details, and how to report a vulnerability.

Disclaimer

This project is independent and is not affiliated with, endorsed by, or sponsored by Figma. "Figma" is a trademark of Figma, Inc., used here only descriptively to indicate compatibility. See DISCLAIMER.md.

License

MIT © Cristina Fores Campos