> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# figma

> Design files and components

**Server path:** `/figma` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                      | Description                                |
| --------------------------------------------------------- | ------------------------------------------ |
| [`figma_get_file`](#figma_get_file)                       | Get a Figma file by key                    |
| [`figma_get_file_nodes`](#figma_get_file_nodes)           | Get specific nodes from a Figma file       |
| [`figma_get_images`](#figma_get_images)                   | Export images from Figma file nodes        |
| [`figma_get_file_versions`](#figma_get_file_versions)     | Get version history of a Figma file        |
| [`figma_get_team_projects`](#figma_get_team_projects)     | Get projects in a Figma team               |
| [`figma_get_project_files`](#figma_get_project_files)     | Get files in a Figma project               |
| [`figma_get_comments`](#figma_get_comments)               | Get comments on a Figma file               |
| [`figma_post_comment`](#figma_post_comment)               | Post a comment on a Figma file             |
| [`figma_get_me`](#figma_get_me)                           | Get current user information               |
| [`figma_get_team_styles`](#figma_get_team_styles)         | Get published styles from a Figma team     |
| [`figma_get_team_components`](#figma_get_team_components) | Get published components from a Figma team |

***

## figma\_get\_file

Get a Figma file by key

**Parameters:**

| Parameter | Type      | Required | Default | Description                                             |
| --------- | --------- | -------- | ------- | ------------------------------------------------------- |
| `fileKey` | string    | Yes      | —       | Figma file key                                          |
| `version` | string    | No       | —       | Specific version ID to retrieve                         |
| `ids`     | string\[] | No       | —       | Comma-separated list of node IDs to retrieve            |
| `depth`   | number    | No       | —       | Depth of the tree to retrieve (0 for just the document) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      },
      "version": {
        "type": "string",
        "description": "Specific version ID to retrieve"
      },
      "ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Comma-separated list of node IDs to retrieve"
      },
      "depth": {
        "type": "number",
        "description": "Depth of the tree to retrieve (0 for just the document)"
      }
    },
    "required": [
      "PCID",
      "fileKey"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_file\_nodes

Get specific nodes from a Figma file

**Parameters:**

| Parameter  | Type      | Required | Default | Description                     |
| ---------- | --------- | -------- | ------- | ------------------------------- |
| `fileKey`  | string    | Yes      | —       | Figma file key                  |
| `nodeIds`  | string\[] | Yes      | —       | Array of node IDs to retrieve   |
| `version`  | string    | No       | —       | Specific version ID to retrieve |
| `depth`    | number    | No       | —       | Depth of the tree to retrieve   |
| `geometry` | string    | No       | —       | Geometry data to include        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      },
      "nodeIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of node IDs to retrieve"
      },
      "version": {
        "type": "string",
        "description": "Specific version ID to retrieve"
      },
      "depth": {
        "type": "number",
        "description": "Depth of the tree to retrieve"
      },
      "geometry": {
        "type": "string",
        "enum": [
          "paths",
          "bounds"
        ],
        "description": "Geometry data to include"
      }
    },
    "required": [
      "PCID",
      "fileKey",
      "nodeIds"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_images

Export images from Figma file nodes

**Parameters:**

| Parameter | Type      | Required | Default | Description                           |
| --------- | --------- | -------- | ------- | ------------------------------------- |
| `fileKey` | string    | Yes      | —       | Figma file key                        |
| `nodeIds` | string\[] | Yes      | —       | Array of node IDs to export as images |
| `format`  | string    | No       | `"png"` | Image format                          |
| `scale`   | number    | No       | —       | Image scale factor                    |
| `version` | string    | No       | —       | Specific version ID to export from    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      },
      "nodeIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of node IDs to export as images"
      },
      "format": {
        "type": "string",
        "enum": [
          "jpg",
          "png",
          "svg",
          "pdf"
        ],
        "default": "png",
        "description": "Image format"
      },
      "scale": {
        "type": "number",
        "description": "Image scale factor"
      },
      "version": {
        "type": "string",
        "description": "Specific version ID to export from"
      }
    },
    "required": [
      "PCID",
      "fileKey",
      "nodeIds"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_file\_versions

Get version history of a Figma file

**Parameters:**

| Parameter | Type   | Required | Default | Description    |
| --------- | ------ | -------- | ------- | -------------- |
| `fileKey` | string | Yes      | —       | Figma file key |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      }
    },
    "required": [
      "PCID",
      "fileKey"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_team\_projects

Get projects in a Figma team

**Parameters:**

| Parameter | Type   | Required | Default | Description   |
| --------- | ------ | -------- | ------- | ------------- |
| `teamId`  | string | Yes      | —       | Figma team ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "teamId": {
        "type": "string",
        "description": "Figma team ID"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_project\_files

Get files in a Figma project

**Parameters:**

| Parameter    | Type    | Required | Default | Description                   |
| ------------ | ------- | -------- | ------- | ----------------------------- |
| `projectId`  | string  | Yes      | —       | Figma project ID              |
| `branchData` | boolean | No       | `false` | Include branch data for files |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "projectId": {
        "type": "string",
        "description": "Figma project ID"
      },
      "branchData": {
        "type": "boolean",
        "default": false,
        "description": "Include branch data for files"
      }
    },
    "required": [
      "PCID",
      "projectId"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_comments

Get comments on a Figma file

**Parameters:**

| Parameter  | Type    | Required | Default | Description                    |
| ---------- | ------- | -------- | ------- | ------------------------------ |
| `fileKey`  | string  | Yes      | —       | Figma file key                 |
| `asVector` | boolean | No       | `false` | Return comments as vector data |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      },
      "asVector": {
        "type": "boolean",
        "default": false,
        "description": "Return comments as vector data"
      }
    },
    "required": [
      "PCID",
      "fileKey"
    ]
  }
  ```
</Expandable>

***

## figma\_post\_comment

Post a comment on a Figma file

**Parameters:**

| Parameter    | Type   | Required | Default | Description                |
| ------------ | ------ | -------- | ------- | -------------------------- |
| `fileKey`    | string | Yes      | —       | Figma file key             |
| `message`    | string | Yes      | —       | Comment message text       |
| `clientMeta` | object | Yes      | —       | Comment placement metadata |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "fileKey": {
        "type": "string",
        "description": "Figma file key"
      },
      "message": {
        "type": "string",
        "description": "Comment message text"
      },
      "clientMeta": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "X coordinate for comment placement"
          },
          "y": {
            "type": "number",
            "description": "Y coordinate for comment placement"
          },
          "nodeId": {
            "type": "string",
            "description": "Node ID to attach comment to"
          }
        },
        "description": "Comment placement metadata"
      }
    },
    "required": [
      "PCID",
      "fileKey",
      "message",
      "clientMeta"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_me

Get current user information

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_team\_styles

Get published styles from a Figma team

**Parameters:**

| Parameter | Type   | Required | Default | Description   |
| --------- | ------ | -------- | ------- | ------------- |
| `teamId`  | string | Yes      | —       | Figma team ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "teamId": {
        "type": "string",
        "description": "Figma team ID"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## figma\_get\_team\_components

Get published components from a Figma team

**Parameters:**

| Parameter  | Type   | Required | Default | Description                    |
| ---------- | ------ | -------- | ------- | ------------------------------ |
| `teamId`   | string | Yes      | —       | Figma team ID                  |
| `pageSize` | number | No       | `30`    | Number of components to return |
| `after`    | string | No       | —       | Cursor for pagination          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "teamId": {
        "type": "string",
        "description": "Figma team ID"
      },
      "pageSize": {
        "type": "number",
        "default": 30,
        "description": "Number of components to return"
      },
      "after": {
        "type": "string",
        "description": "Cursor for pagination"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>