Figma

Returns a status object confirming the server is running and reachable.

Inputs: (none)

Output:

{
  "status": "ok",
  "server": "CL Figma MCP Server"
}

Returns the profile of the Figma user associated with the connected credential.

Inputs: (none)

Output:

{
  "id": "123456789",
  "email": "user@example.com",
  "handle": "username",
  "img_url": "https://..."
}

Fetches the full document tree of a Figma file. Use depth to limit how deep the node tree is returned and reduce response size.

Inputs:

- `file_key` (string, required)  — Unique key identifying the Figma file (found in the file URL)
- `depth`    (integer, optional) — Depth of the node tree to return (default: full tree)

output:

{
  "name": "My Design File",
  "lastModified": "2024-01-01T00:00:00Z",
  "document": { 

Fetches one or more specific nodes from a Figma file by their node IDs, rather than the full document tree.

Inputs:

- `file_key`  (string, required)  — Unique key identifying the Figma file
- `node_ids`  (string, required)  — Comma-separated list of node IDs to retrieve (e.g. '1:2,3:4')
- `depth`     (integer, optional) — Depth of the node subtree to return

output:

{
  "nodes": {
    "1:2": { "document"

Returns all locally-defined components in a Figma file, including their keys and descriptions.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file

output:

{
  "meta": {
    "components": [
      { "key": "abc123", "name": "Button/Primary", "description": "" }
    ]
  }

Returns all local styles (colors, text, effects, grids) defined in a Figma file.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file

output:

{
  "meta": {
    "styles": [
      { "key": "def456", "name": "Primary/Blue", "style_type": "FILL" }
    ]
  }

Returns the full version history of a Figma file, including version labels and timestamps.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file

output:

{
  "versions": [
    { "id": "v1", "label": "Final Review", "created_at": "2024-01-01T00:00:00Z" }
  ]
}

Renders one or more nodes as images and returns signed download URLs. Supports PNG, JPG, SVG, and PDF formats.

Inputs:

- `file_key`  (string, required)  — Unique key identifying the Figma file
- `node_ids`  (string, required)  — Comma-separated list of node IDs to export (e.g. '1:2,3:4')
- `scale`     (float, optional)   — Export scale factor between 0.01 and 4 (default: 1)
- `format`    (string, optional)  — Image format: 'jpg', 'png', 'svg', or 'pdf' (default: 'png')

output:

Returns download URLs for all images embedded in a Figma file as image fills on nodes.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file

output:

{
  "meta": {
    "images": { "imageRef123": "https://..." }
  }
}

Returns all comments on a Figma file, including resolved and unresolved threads.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file

output:

{
  "comments": [
    { "id": "c1", "message": "Looks good!", "resolved_at": null }
  ]
}

Adds a new comment to a Figma file on behalf of the authenticated user.

Inputs:

- `file_key` (string, required) — Unique key identifying the Figma file
- `message`  (string, required) — The comment text to post

output:

{
  "id": "c2",
  "message": "Please update the button radius.",
  "created_at": "2024-01-01T00:00:00Z"
}

Returns all projects belonging to a Figma team.

Inputs:

- `team_id` (string, required) — The Figma team ID

output:

{
  "projects": [
    { "id": "12345", "name": "Design System" }
  ]
}

Returns all files within a specific Figma project.

Inputs:

- `project_id` (string, required) — The Figma project ID

output:

{
  "files": [
    { "key": "abc123", "name": "Components v2", "last_modified": "2024-01-01T00:00:00Z" }
  ]
}

Returns all published components available in a Figma team's shared component library.

Inputs:

- `team_id` (string, required) — The Figma team ID

output:

{
  "meta": {
    "components": [
      { "key": "ghi789", "name": "Icon/Close", "file_key": "abc123" }
    ]
  }

Retrieves metadata for a single published component by its unique component key.

Inputs:

- `component_key` (string, required) — The unique key of the published component

output:

{
  "meta": {
    "key": "ghi789",
    "name": "Icon/Close",
    "description": "Close icon, 24px",
    "file_key": "abc123"
  }

• file_key — The unique identifier of a Figma file, extracted from its URL: figma.com/file/{file_key}/...
• node_ids — Comma-separated node IDs in {pageId}:{nodeId} format, e.g. 1:2,3:4
• depth — Integer controlling how many levels of the node tree to return; omit for the full tree

File Key:

{alphanumeric string from URL}
Example: aBcDeFgHiJkLmNoP

node ID:

{page}:{node}
Example: 1:2  (page 1, node 2)

• png — Raster, default format (default scale: 1×)
• jpg — Raster, smaller file size, no transparency
• svg — Vector, ideal for icons and simple shapes
• pdf — Vector, suitable for print

Scale range: 0.01 – 4 (e.g. 2 for @2x retina export)

• Cause: Figma credential not provided in request headers or incorrect format
• Solution:
  1. Verify Authorization: Bearer YOUR_API_KEY and X-Mewcp-Credential-Id: CREDENTIAL-ID headers are present
  2. Check the credential is active in your MewCP account

• Cause: API calls have exceeded your request limits
• Solution:
  1. Check credit usage in your Curious Layer dashboard
  2. Upgrade to a paid plan or add credits for higher limits
  3. Contact support for credit adjustments

• Cause: No Figma credential linked to your account
• Solution:
  1. Go to Credentials in your MewCP dashboard
  2. Connect your Figma account (OAuth)
  3. Retry the request with the correct X-Mewcp-Credential-Id header

• Cause: JSON payload is invalid or missing required fields
• Solution:
  1. Validate JSON syntax before sending
  2. Ensure all required tool parameters are included
  3. Check that node_ids is a comma-separated string, not an array

• Cause: Incorrect server name in the API endpoint
• Solution:
  1. Verify endpoint format: {server-name}/mcp/{tool-name}
  2. Use correct server name from documentation
  3. Check available servers in your Curious Layer account

• Cause: Upstream Figma API returned an error
• Solution:
  1. Check Figma service status at Figma Status Page
  2. Verify your credential has access to the file or team being queried
  3. Review the error message for specific details (e.g. file not found, insufficient permissions)

• Figma REST API Documentation — Official API reference
• Figma Developer Console — Manage apps and access tokens
• FastMCP Docs — FastMCP specification
• FastMCP Credentials — FastMCP Credentials package for credential handling