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 | Default |
|---|---|---|---|
| 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) }], }; }