Basecamp MCP Server

Instructions

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;
  }