basecamp_list_kanban_cards
Retrieve all cards from a specific kanban column in Basecamp projects to view task details and monitor workflow progress.
Instructions
List cards in a kanban column.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_id | Yes | Basecamp resource identifier | |
| column_id | Yes |
Implementation Reference
- src/tools/kanban.ts:297-338 (handler)The handler function for the 'basecamp_list_kanban_cards' tool. It initializes the Basecamp client, lists cards in the specified column using paged API calls, serializes relevant fields including creator, assignees, and steps, and returns formatted JSON.async (params) => { try { const client = await initializeBasecampClient(); const cards = await asyncPagedToArray({ fetchPage: client.cardTableCards.list, request: { params: { bucketId: params.bucket_id, columnId: params.column_id }, query: {}, }, }); return { content: [ { type: "text", text: JSON.stringify( cards.map((c) => ({ id: c.id, title: c.title, due_on: c.due_on, url: c.app_url, comments_count: c.comments_count, created_at: c.created_at, creator: serializePerson(c.creator), assignees: c.assignees.map(serializePerson), steps: c.steps?.map((s) => ({ title: s.title, completed: s.completed, })), })), null, 2, ), }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } },
- src/tools/kanban.ts:283-296 (schema)The input schema and metadata (title, description, annotations) for the 'basecamp_list_kanban_cards' tool, using shared BasecampIdSchema for IDs.{ title: "List Kanban Cards", description: "List cards in a kanban column.", inputSchema: { bucket_id: BasecampIdSchema, column_id: BasecampIdSchema, }, annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, },
- src/tools/kanban.ts:281-339 (registration)The server.registerTool call that registers the 'basecamp_list_kanban_cards' tool, including its name, schema, and handler.server.registerTool( "basecamp_list_kanban_cards", { title: "List Kanban Cards", description: "List cards in a kanban column.", inputSchema: { bucket_id: BasecampIdSchema, column_id: BasecampIdSchema, }, annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, }, async (params) => { try { const client = await initializeBasecampClient(); const cards = await asyncPagedToArray({ fetchPage: client.cardTableCards.list, request: { params: { bucketId: params.bucket_id, columnId: params.column_id }, query: {}, }, }); return { content: [ { type: "text", text: JSON.stringify( cards.map((c) => ({ id: c.id, title: c.title, due_on: c.due_on, url: c.app_url, comments_count: c.comments_count, created_at: c.created_at, creator: serializePerson(c.creator), assignees: c.assignees.map(serializePerson), steps: c.steps?.map((s) => ({ title: s.title, completed: s.completed, })), })), null, 2, ), }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } }, );