get-all-tags
Retrieve all tags from a Miro board by specifying the board ID. Use optional parameters like limit and offset for paginated results.
Instructions
Retrieve all tags on a Miro board
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | Unique identifier (ID) of the board for which you want to retrieve all tags | |
| limit | No | Maximum number of tags to return (default: 50) | |
| offset | No | Offset for pagination (default: 0) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Unique identifier (ID) of the board for which you want to retrieve all tags",
"type": "string"
},
"limit": {
"description": "Maximum number of tags to return (default: 50)",
"type": "number"
},
"offset": {
"description": "Offset for pagination (default: 0)",
"type": "number"
}
},
"required": [
"boardId"
],
"type": "object"
}
Implementation Reference
- src/tools/getAllTags.ts:14-35 (handler)The handler function that implements the core logic of the 'get-all-tags' tool. It validates the boardId, constructs a query object with optional limit and offset for pagination, fetches tags using MiroClient.getApi().getTagsFromBoard, and returns the JSON-formatted result or an error response.fn: async ({ boardId, limit, offset }) => { try { if (!boardId) { return ServerResponse.error("Board ID is required"); } const query: Record<string, any> = {}; if (limit !== undefined) { query.limit = limit; } if (offset !== undefined) { query.offset = offset; } const result = await MiroClient.getApi().getTagsFromBoard(boardId, query); return ServerResponse.text(JSON.stringify(result, null, 2)); } catch (error) { return ServerResponse.error(error); } }
- src/tools/getAllTags.ts:9-13 (schema)The input schema definition using Zod for the 'get-all-tags' tool parameters: required boardId (string), optional limit and offset (numbers).args: { boardId: z.string().describe("Unique identifier (ID) of the board for which you want to retrieve all tags"), limit: z.number().optional().nullish().describe("Maximum number of tags to return (default: 50)"), offset: z.number().optional().nullish().describe("Offset for pagination (default: 0)") },
- src/index.ts:167-167 (registration)The registration of the getAllTagsTool schema and handler into the ToolBootstrapper instance in the main entry point..register(getAllTagsTool)
- src/tools/getAllTags.ts:7-8 (schema)The tool name and description definition, part of the ToolSchema.name: "get-all-tags", description: "Retrieve all tags on a Miro board",
- src/index.ts:67-67 (registration)The import statement that brings in the getAllTagsTool from its implementation file for registration.import getAllTagsTool from './tools/getAllTags.js';