get_cards
Retrieve all cards from a specific column in Basecamp by providing the project ID and column ID. This tool supports project management and task tracking through Basecamp integration.
Instructions
Get all cards in a column
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| column_id | Yes | The column ID | |
| project_id | Yes | The project ID |
Implementation Reference
- src/index.ts:635-647 (handler)MCP tool handler for 'get_cards': extracts arguments, calls client.getCards(), formats response as JSON text content.case 'get_cards': { const cards = await client.getCards(typedArgs.project_id, typedArgs.column_id); return { content: [{ type: 'text', text: JSON.stringify({ status: 'success', cards, count: cards.length }, null, 2) }] }; }
- src/index.ts:203-210 (schema)Input schema defining required project_id and column_id parameters for the get_cards tool.inputSchema: { type: 'object', properties: { project_id: { type: 'string', description: 'The project ID' }, column_id: { type: 'string', description: 'The column ID' }, }, required: ['project_id', 'column_id'], },
- src/index.ts:200-211 (registration)Registration of the 'get_cards' tool in the MCP tools list, including name, description, and input schema.{ name: 'get_cards', description: 'Get all cards in a column', inputSchema: { type: 'object', properties: { project_id: { type: 'string', description: 'The project ID' }, column_id: { type: 'string', description: 'The column ID' }, }, required: ['project_id', 'column_id'], }, },
- src/lib/basecamp-client.ts:200-203 (helper)Helper method in BasecampClient that performs the actual API call to retrieve cards from a specific column.async getCards(projectId: string, columnId: string): Promise<Card[]> { const response = await this.client.get(`/buckets/${projectId}/card_tables/lists/${columnId}/cards.json`); return response.data; }