Miro MCP

Instructions

Implementation Reference

• src/tools/deleteShapeItem.ts:13-28 (handler)

  The main handler function for the 'delete-shape-item' tool. It validates the boardId and itemId inputs, calls the MiroClient API to delete the shape item, and returns a success or error response.

  fn: async ({ boardId, itemId }) => {
    try {
      if (!boardId) {
        return ServerResponse.error("Board ID is required");
      }
  
      if (!itemId) {
        return ServerResponse.error("Item ID is required");
      }
  
      await MiroClient.getApi().deleteShapeItem(boardId, itemId);
      return ServerResponse.text(JSON.stringify({ success: true, message: "Shape deleted successfully" }, null, 2));
    } catch (error) {
      return ServerResponse.error(error);
    }
  }

• src/tools/deleteShapeItem.ts:9-12 (schema)

  Zod schema defining the input parameters for the tool: boardId (string) and itemId (string).

  args: {
    boardId: z.string().describe("Unique identifier (ID) of the board that contains the shape"),
    itemId: z.string().describe("Unique identifier (ID) of the shape that you want to delete")
  },

• src/index.ts:160-160 (registration)

  Registers the deleteShapeItemTool with the ToolBootstrapper instance, making the tool available in the MCP server.

  .register(deleteShapeItemTool)

• src/index.ts:60-60 (registration)

  Imports the deleteShapeItemTool definition from its module for use in registration.

  import deleteShapeItemTool from './tools/deleteShapeItem.js';