Miro MCP

Instructions

Implementation Reference

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

  The main handler function for the 'get-card-item' tool. It validates the boardId and itemId parameters, fetches the card item data using MiroClient.getApi().getCardItem, and returns the JSON stringified response or an error.

  fn: async ({ boardId, itemId }) => {
    try {
      if (!boardId) {
        return ServerResponse.error("Board ID is required");
      }
      
      if (!itemId) {
        return ServerResponse.error("Item ID is required");
      }
  
      const itemData = await MiroClient.getApi().getCardItem(boardId, itemId);
  
      return ServerResponse.text(JSON.stringify(itemData, null, 2));
    } catch (error) {
      return ServerResponse.error(error);
    }
  }

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

  The ToolSchema definition for 'get-card-item', including the tool name, description, and Zod schemas for input parameters boardId and itemId.

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

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

  Registration of the getCardItemTool using the ToolBootstrapper's register method on the MCP server.

  .register(getCardItemTool)

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

  Import of the getCardItemTool from its definition file, enabling registration.

  import getCardItemTool from './tools/getCardItem.js';