Miro MCP

Instructions

Implementation Reference

• src/tools/getImageItem.ts:13-29 (handler)

  The async handler function implementing the core logic of the 'get-image-item' tool: validates boardId and itemId, fetches the image item via MiroClient API, and returns JSON response or error.

  fn: async ({ boardId, itemId }) => {
    try {
      if (!boardId) {
        return ServerResponse.error("Board ID is required");
      }
  
      if (!itemId) {
        return ServerResponse.error("Item ID is required");
      }
  
      // Use generic getItem for image item
      const result = await MiroClient.getApi().getImageItem(boardId, itemId);
      return ServerResponse.text(JSON.stringify(result, null, 2));
    } catch (error) {
      return ServerResponse.error(error);
    }
  }

• src/tools/getImageItem.ts:6-12 (schema)

  The ToolSchema definition providing the tool name, description, and Zod-validated input schema for boardId and itemId parameters.

  const getImageItemTool: ToolSchema = {
    name: "get-image-item",
    description: "Retrieve information about a specific image item on a Miro board",
    args: {
      boardId: z.string().describe("Unique identifier (ID) of the board that contains the image"),
      itemId: z.string().describe("Unique identifier (ID) of the image that you want to retrieve")
    },

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

  Registers the getImageItemTool with the ToolBootstrapper instance, making the 'get-image-item' tool available to the MCP server.

  .register(getImageItemTool)