mcp-figma

Instructions

Implementation Reference

• src/handlers/files.ts:28-37 (handler)

  The core handler function getFileNodes that executes the tool logic by calling the Figma API /files/{fileKey}/nodes endpoint with joined node_ids.

  async getFileNodes(args: GetFileNodesArgs) {
    const { fileKey, node_ids, ...otherParams } = args;
    
    const params: Record<string, string | number | boolean | undefined> = {
      ...otherParams,
      ids: node_ids.join(',')
    };
  
    return this.api.makeRequest(`/files/${fileKey}/nodes${this.api.buildQueryString(params)}`);
  }

• src/index.ts:141-166 (registration)

  Tool registration in the list of tools provided by the MCP server, including name, description, and input schema.

    name: 'get_file_nodes',
    description: 'Get specific nodes from a Figma file',
    inputSchema: {
      type: 'object',
      properties: {
        fileKey: {
          type: 'string',
          description: 'The key of the file to get nodes from'
        },
        node_ids: {
          type: 'array',
          items: { type: 'string' },
          description: 'Array of node IDs to get'
        },
        depth: {
          type: 'number',
          description: 'Optional. Depth of nodes to return (1-4)'
        },
        version: {
          type: 'string',
          description: 'Optional. A specific version ID to get'
        }
      },
      required: ['fileKey', 'node_ids']
    },
  },

• src/index.ts:498-504 (registration)

  Dispatch logic in the CallToolRequestHandler switch statement that handles 'get_file_nodes' tool calls by validating args and invoking the filesHandler.

  case 'get_file_nodes': {
    const args = this.validateArgs<GetFileNodesArgs>(request.params.arguments, ['fileKey', 'node_ids']);
    const result = await this.filesHandler.getFileNodes(args);
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
    };
  }

• src/types/files.ts:8-11 (schema)

  TypeScript interface defining the input arguments for the get_file_nodes tool.

  export interface GetFileNodesArgs extends BaseParams {
    fileKey: string;
    node_ids: string[];
  }