list_user_packages

Retrieve and filter packages for a GitHub user by type and visibility to manage dependencies and access control.

Instructions

List packages for a user

Input Schema

TableJSON Schema

Name	Required	Description
`username`	Yes	Username
`package_type`	No	The type of package to filter for
`visibility`	No	The visibility to filter for
`per_page`	No	Results per page (max 100)
`page`	No	Page number of the results

Implementation Reference

src/operations/packages.ts:122-141 (handler)

The core handler function that executes the list_user_packages tool by constructing the GitHub API URL for user packages and fetching/parsing the response.

export async function listUserPackages(
  github_pat: string,
  username: string,
  options: {
    package_type?: "npm" | "maven" | "rubygems" | "docker" | "nuget" | "container";
    visibility?: "public" | "private" | "internal";
    per_page?: number;
    page?: number;
  } = { package_type: "npm" }
): Promise<z.infer<typeof PackageSchema>[]> {
  const url = new URL(`https://api.github.com/users/${username}/packages`);
  
  if (options.package_type) url.searchParams.append("package_type", options.package_type);
  if (options.visibility) url.searchParams.append("visibility", options.visibility);
  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());
  return z.array(PackageSchema).parse(response);
}

src/operations/packages.ts:45-55 (schema)

Input schema definitions for the list_user_packages tool, including the public schema and the internal schema extended with github_pat.

export const ListUserPackagesSchema = z.object({
  username: z.string().describe("Username"),
  package_type: z.enum(["npm", "maven", "rubygems", "docker", "nuget", "container"]).optional().describe("The type of package to filter for"),
  visibility: z.enum(["public", "private", "internal"]).optional().describe("The visibility to filter for"),
  per_page: z.number().optional().describe("Results per page (max 100)"),
  page: z.number().optional().describe("Page number of the results"),
});

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

src/index.ts:280-284 (registration)

Tool registration in the MCP server's list of tools, defining name, description, and input schema.

{
  name: "list_user_packages",
  description: "List packages for a user",
  inputSchema: zodToJsonSchema(packages.ListUserPackagesSchema),
},

src/index.ts:740-747 (handler)

Dispatch handler in the main CallToolRequest handler that parses arguments and calls the listUserPackages function.

case "list_user_packages": {
  const args = packages._ListUserPackagesSchema.parse(params.arguments);
  const { github_pat, username, ...options } = args;
  const result = await packages.listUserPackages(github_pat, username, options);
  return {
    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
  };
}

mcp-github