get_board
Retrieve details for a specific project board by providing its board ID, enabling AI assistants to access and manage board information within the FluentBoards project management system.
Instructions
Get details of a specific board
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | Board ID |
Implementation Reference
- src/tools/boards.ts:38-49 (handler)Handler function that validates access to the board, fetches board details using the API client, and returns a formatted response.
async (args) => { const { board_id } = args; // Validate board access const accessCheck = validateBoardAccess(board_id); if (!accessCheck.allowed) { return formatResponse(createBoardFocusError(accessCheck)); } const response = await api.get(`/projects/${board_id}`); return formatResponse(response.data); } - src/tools/boards.ts:35-37 (schema)Zod input schema defining board_id as a positive integer.
{ board_id: z.number().int().positive().describe("Board ID"), }, - src/tools/boards.ts:32-50 (registration)Registers the get_board tool on the MCP server with name, description, input schema, and handler function.
server.tool( "get_board", "Get details of a specific board", { board_id: z.number().int().positive().describe("Board ID"), }, async (args) => { const { board_id } = args; // Validate board access const accessCheck = validateBoardAccess(board_id); if (!accessCheck.allowed) { return formatResponse(createBoardFocusError(accessCheck)); } const response = await api.get(`/projects/${board_id}`); return formatResponse(response.data); } ); - src/utils/index.ts:169-187 (helper)Helper function to validate if access to a specific board is allowed based on board focus configuration. Used in get_board handler.
export function validateBoardAccess(boardId: number): BoardFocusResult { const { boardFocus } = config; // If board focus is not enabled, allow all boards if (!boardFocus.enabled || !boardFocus.boardId) { return { allowed: true }; } // Check if the requested board matches the focused board if (boardId !== boardFocus.boardId) { return { allowed: false, reason: `Operations are focused on board ${boardFocus.boardId}. Access to board ${boardId} is outside the current focus scope.`, code: "OUT_OF_FOCUS" }; } return { allowed: true }; }