Documentation

Everything you need to integrate Composa with your AI assistant and start designing with AI.

Quick Start

1. Get your API key

Sign up at composa.dev and create an API key from the dashboard.

2. Configure your MCP client

Add Composa to your AI assistant's MCP configuration:

mcp.json
{
  "mcpServers": {
    "composa": {
      "url": "https://mcp.composa.dev/mcp",
      "env": {
        "COMPOSA_API_KEY": "your-api-key"
      }
    }
  }
}

3. Install the Figma plugin

Open Figma, go to Plugins → Development → Import plugin from manifest, and load the Composa plugin. Once running, the plugin connects to the Composa server automatically.

4. Start designing

Open your AI assistant and ask it to create, modify, or inspect your Figma designs. Composa handles all communication between your AI and Figma.

Compatible MCP Clients

Claude CodeAnthropic's CLI for Claude
CursorAI-first code editor
WindsurfAI-powered IDE
Claude DesktopDesktop app via MCPB proxy
ChatGPT DesktopOpenAI desktop (MCP support)
Any MCP ClientStreamable HTTP transport

Free Tools (12 read-only)

Available on all plans including the free tier. Inspect and read your Figma designs.

get_document_infoGet current document metadata
get_selectionGet the current selection in Figma
get_node_infoInspect a single node's properties
get_nodes_infoInspect multiple nodes at once
get_stylesList all local styles
get_local_componentsList local components
get_remote_componentsList remote (library) components
scan_text_nodesFind all text nodes in the document
get_styled_text_segmentsGet text segments with style info
get_pagesList all pages in the document
join_channelConnect to a Figma design channel
get_connection_statusCheck Figma plugin connection

Pro Tools (41 write tools)

Available on Pro, Team, and Enterprise plans. Full write access to create and modify designs.

Creation

create_rectangleCreate a rectangle shape
create_frameCreate a frame (artboard)
create_textCreate a text node
create_ellipseCreate an ellipse/circle
create_polygonCreate a polygon shape
create_starCreate a star shape

Modification

set_fill_colorChange fill color
set_stroke_colorChange stroke color
move_nodeMove a node to new position
resize_nodeResize a node
delete_nodeDelete a node
set_corner_radiusSet corner radius
set_auto_layoutConfigure auto layout
set_effectsApply visual effects
set_effect_style_idApply an effect style
rename_nodeRename a node

Typography

set_text_contentChange text content
set_multiple_text_contentsBatch update text
set_font_nameChange font family
set_font_sizeChange font size
set_font_weightChange font weight
set_letter_spacingAdjust letter spacing
set_line_heightAdjust line height
set_paragraph_spacingAdjust paragraph spacing
set_text_caseChange text case
set_text_decorationAdd underline/strikethrough
load_font_asyncLoad a font for use
set_text_style_idApply a text style

Advanced

export_node_as_imageExport node as PNG/SVG/PDF
clone_nodeDuplicate a node
group_nodesGroup multiple nodes
ungroup_nodesUngroup nodes
insert_childMove node into a parent
flatten_nodeFlatten a node

Components

create_component_instanceCreate component instance
create_component_from_nodeConvert node to component
create_component_setCreate a component set (variants)

Page Management

create_pageCreate a new page
delete_pageDelete a page
rename_pageRename a page
set_current_pageSwitch active page

Architecture

Composa is a fully remote MCP server. No code runs on your machine — your AI assistant connects directly to the cloud.

AI Assistant (Claude, Cursor, ...)
↓ Streamable HTTP
Composa MCP Server (cloud)
↓ WebSocket
Composa Figma Plugin (your browser)
↓ Figma Plugin API
Your Figma Design

API Key Prefixes

Each API key starts with a prefix indicating the plan tier:

comp_free_Free12 read-only
comp_pro_ProAll 50+ tools
comp_team_TeamAll + team features
comp_ent_EnterpriseAll + SSO, SLA

Support

Need help? Reach out at [email protected] or open an issue on GitHub.