get-card-item
Retrieve detailed information about a specific card on a Miro board by providing the board ID and card ID. Enhances workflow efficiency by accessing card data directly.
Instructions
Retrieve information about a specific card item on a Miro board
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | Unique identifier (ID) of the board that contains the card | |
| itemId | Yes | Unique identifier (ID) of the card that you want to retrieve |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Unique identifier (ID) of the board that contains the card",
"type": "string"
},
"itemId": {
"description": "Unique identifier (ID) of the card that you want to retrieve",
"type": "string"
}
},
"required": [
"boardId",
"itemId"
],
"type": "object"
}
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 from the Miro API using MiroClient, stringifies it to JSON, and returns it wrapped in ServerResponse.text, or an error response if validation or API call fails.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:7-12 (schema)The tool schema definition including the name, description, and input parameters schema using Zod (z.string() for boardId and itemId with descriptions).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:25-25 (registration)Import statement for the getCardItemTool from its source file.import getCardItemTool from './tools/getCardItem.js';
- src/index.ts:126-126 (registration)Registration of the getCardItemTool in the ToolBootstrapper instance via the .register() method chain..register(getCardItemTool)