basecamp_list_kanban_columns
Retrieve all columns from a Basecamp kanban board to view workflow stages and organize project tasks.
Instructions
List all columns in a kanban board.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_id | Yes | Basecamp resource identifier | |
| card_table_id | Yes |
Implementation Reference
- src/tools/kanban.ts:238-278 (handler)Handler function that fetches and returns the list of kanban columns for a given bucket and card table.async (params) => { try { const client = await initializeBasecampClient(); const response = await client.cardTables.get({ params: { bucketId: params.bucket_id, cardTableId: params.card_table_id, }, }); if (response.status !== 200 || !response.body) { throw new Error("Failed to fetch card table"); } const columns = response.body.lists || []; return { content: [ { type: "text", text: JSON.stringify( columns.map((col) => ({ id: col.id, title: col.title, position: col.position, cards_count: col.cards_count, type: col.type, description: col.description, })), null, 2, ), }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } },
- src/tools/kanban.ts:222-279 (registration)Registers the 'basecamp_list_kanban_columns' tool with MCP server, including schema and handler.server.registerTool( "basecamp_list_kanban_columns", { title: "List Kanban Columns", description: "List all columns in a kanban board.", inputSchema: { bucket_id: BasecampIdSchema, card_table_id: BasecampIdSchema, }, annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, }, async (params) => { try { const client = await initializeBasecampClient(); const response = await client.cardTables.get({ params: { bucketId: params.bucket_id, cardTableId: params.card_table_id, }, }); if (response.status !== 200 || !response.body) { throw new Error("Failed to fetch card table"); } const columns = response.body.lists || []; return { content: [ { type: "text", text: JSON.stringify( columns.map((col) => ({ id: col.id, title: col.title, position: col.position, cards_count: col.cards_count, type: col.type, description: col.description, })), null, 2, ), }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } }, );
- src/tools/kanban.ts:224-237 (schema)Tool metadata, input schema (using shared BasecampIdSchema), and annotations.{ title: "List Kanban Columns", description: "List all columns in a kanban board.", inputSchema: { bucket_id: BasecampIdSchema, card_table_id: BasecampIdSchema, }, annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, },