Basecamp MCP Server

Instructions

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