list_releases
Retrieve release information from GitHub repositories to track version history and download assets.
Instructions
List releases for a GitHub repository
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | Yes | Repository owner (username or organization) | |
| repo | Yes | Repository name | |
| per_page | No | Results per page (max 100) | |
| page | No | Page number of the results |
Implementation Reference
- src/operations/releases.ts:145-158 (handler)Core handler function that fetches and parses the list of releases from the GitHub API.
export async function listReleases( github_pat: string, owner: string, repo: string, options: { per_page?: number; page?: number } = {} ): Promise<z.infer<typeof ReleaseSchema>[]> { const url = new URL(`https://api.github.com/repos/${owner}/${repo}/releases`); 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(ReleaseSchema).parse(response); } - src/operations/releases.ts:71-76 (schema)Input schema definition for the list_releases tool, used for validation.
export const ListReleasesSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), per_page: z.number().optional().describe("Results per page (max 100)"), page: z.number().optional().describe("Page number of the results") }); - src/index.ts:169-173 (registration)Tool registration in the ListToolsRequest handler, exposing the tool with its schema.
{ name: "list_releases", description: "List releases for a GitHub repository", inputSchema: zodToJsonSchema(releases.ListReleasesSchema), }, - src/index.ts:542-549 (registration)Dispatch handler in the CallToolRequest switch that parses args and calls the listReleases function.
case "list_releases": { const args = releases._ListReleasesSchema.parse(params.arguments); const { github_pat, owner, repo, ...options } = args; const result = await releases.listReleases(github_pat, owner, repo, options); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }