get_dartboard
Retrieve detailed information about a specific dartboard, including its title, description, and associated tasks, by providing its unique 12-character alphanumeric ID.
Instructions
Retrieve an existing dartboard by its ID. Returns the dartboard's information including title, description, and all tasks within it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The 12-character alphanumeric ID of the dartboard |
Implementation Reference
- index.ts:493-499 (handler)Handler for the get_dartboard tool: validates the ID argument, retrieves the dartboard using DartboardService, and returns the JSON-serialized result.
case GET_DARTBOARD_TOOL.name: { const id = getIdValidated(args.id); const dartboard = await DartboardService.getDartboard(id); return { content: [{ type: "text", text: JSON.stringify(dartboard, null, 2) }], }; } - tools.ts:581-596 (schema)Defines the tool's metadata: name, description, and input schema requiring a 12-character alphanumeric 'id'.
export const GET_DARTBOARD_TOOL: Tool = { name: "get_dartboard", description: "Retrieve an existing dartboard by its ID. Returns the dartboard's information including title, description, and all tasks within it.", inputSchema: { type: "object", properties: { id: { type: "string", description: "The 12-character alphanumeric ID of the dartboard", pattern: "^[a-zA-Z0-9]{12}$", }, }, required: ["id"], }, }; - index.ts:192-214 (registration)Registers the get_dartboard tool (as GET_DARTBOARD_TOOL) in the TOOLS array provided to the MCP server's ListToolsRequestHandler.
const TOOLS = [ // Config GET_CONFIG_TOOL, // Tasks CREATE_TASK_TOOL, LIST_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, // Docs CREATE_DOC_TOOL, LIST_DOCS_TOOL, GET_DOC_TOOL, UPDATE_DOC_TOOL, DELETE_DOC_TOOL, // Comments ADD_TASK_COMMENT_TOOL, LIST_TASK_COMMENTS_TOOL, // Other GET_DARTBOARD_TOOL, GET_FOLDER_TOOL, GET_VIEW_TOOL, ];