list_project_columns

Retrieve and display all columns from a GitHub project to organize tasks and track workflow progress.

Instructions

List columns for a project

Input Schema

TableJSON Schema

Name	Required	Description
`project_id`	Yes	The ID of the project
`per_page`	No	Results per page (max 100)
`page`	No	Page number of the results

Implementation Reference

src/operations/projects.ts:153-176 (handler)

The core handler function that implements the logic to list project columns by querying the GitHub API and parsing the response with Zod.

export async function listProjectColumns(
  github_pat: string,
  project_id: number,
  options: {
    per_page?: number;
    page?: number;
  } = {}
): Promise<z.infer<typeof ProjectColumnSchema>[]> {
  const url = new URL(`https://api.github.com/projects/${project_id}/columns`);
  
  if (options.per_page) url.searchParams.append("per_page", options.per_page.toString());
  if (options.page) url.searchParams.append("page", options.page.toString());
  
  const response = await githubRequest(
    github_pat,
    url.toString(),
    {
      headers: {
        "Accept": "application/vnd.github.inertia-preview+json",
      },
    }
  );
  return z.array(ProjectColumnSchema).parse(response);
}

src/operations/projects.ts:72-80 (schema)

Input schema definitions for the list_project_columns tool, including parameters for project_id, pagination, and the internal schema with github_pat.

export const ListProjectColumnsSchema = z.object({
  project_id: z.number().describe("The ID of the project"),
  per_page: z.number().optional().describe("Results per page (max 100)"),
  page: z.number().optional().describe("Page number of the results"),
});

export const _ListProjectColumnsSchema = ListProjectColumnsSchema.extend({
  github_pat: z.string().describe("GitHub Personal Access Token"),
});

src/operations/projects.ts:22-31 (schema)

Output schema for individual project columns returned by the GitHub API.

export const ProjectColumnSchema = z.object({
  id: z.number(),
  node_id: z.string(),
  url: z.string(),
  project_url: z.string(),
  cards_url: z.string(),
  name: z.string(),
  created_at: z.string(),
  updated_at: z.string(),
});

src/index.ts:259-263 (registration)

Tool registration in the MCP tools array, defining name, description, and input schema.

{
  name: "list_project_columns",
  description: "List columns for a project",
  inputSchema: zodToJsonSchema(projects.ListProjectColumnsSchema),
},

src/index.ts:703-710 (registration)

Dispatcher case in the main request handler that parses arguments and calls the listProjectColumns implementation.

case "list_project_columns": {
  const args = projects._ListProjectColumnsSchema.parse(params.arguments);
  const { github_pat, project_id, ...options } = args;
  const result = await projects.listProjectColumns(github_pat, project_id, options);
  return {
    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
  };
}

mcp-github