Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/server.ts:946-983 (handler)

  The handler function for the 'join_channel' MCP tool. It validates the channel input, calls the joinChannel helper, and returns success or error messages.

  async ({ channel }) => {
    try {
      if (!channel) {
        // If no channel provided, ask the user for input
        return {
          content: [
            {
              type: "text",
              text: "Please provide a channel name to join:"
            }
          ],
          followUp: {
            tool: "join_channel",
            description: "Join the specified channel"
          }
        };
      }
  
      await joinChannel(channel);
      return {
        content: [
          {
            type: "text",
            text: `Successfully joined channel: ${channel}`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error joining channel: ${error instanceof Error ? error.message : String(error)}`
          }
        ]
      };
    }
  }

• src/talk_to_figma_mcp/server.ts:943-945 (schema)

  Zod schema defining the input parameter 'channel' for the join_channel tool.

  {
    channel: z.string().describe("The name of the channel to join").default("")
  },

• src/talk_to_figma_mcp/server.ts:940-984 (registration)

  Registration of the 'join_channel' tool using McpServer.tool method, including description, schema, and handler.

  server.tool(
    "join_channel",
    "Join a specific channel to communicate with Figma",
    {
      channel: z.string().describe("The name of the channel to join").default("")
    },
    async ({ channel }) => {
      try {
        if (!channel) {
          // If no channel provided, ask the user for input
          return {
            content: [
              {
                type: "text",
                text: "Please provide a channel name to join:"
              }
            ],
            followUp: {
              tool: "join_channel",
              description: "Join the specified channel"
            }
          };
        }
  
        await joinChannel(channel);
        return {
          content: [
            {
              type: "text",
              text: `Successfully joined channel: ${channel}`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error joining channel: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/talk_to_figma_mcp/server.ts:874-887 (helper)

  Helper function that sends the 'join' command to Figma via WebSocket and updates the current channel state.

  async function joinChannel(channelName: string): Promise<void> {
    if (!ws || ws.readyState !== WebSocket.OPEN) {
      throw new Error('Not connected to Figma');
    }
  
    try {
      await sendCommandToFigma('join', { channel: channelName });
      currentChannel = channelName;
      console.info(`Joined channel: ${channelName}`);
    } catch (error) {
      console.error(`Failed to join channel: ${error instanceof Error ? error.message : String(error)}`);
      throw error;
    }
  }