GitHub MCP Server

Instructions

Implementation Reference

• operations/pulls.ts:288-302 (handler)

  Core handler function that implements the get_pull_request_status tool logic: fetches the PR to get head SHA, then retrieves and parses the combined commit status from GitHub API.
  export async function getPullRequestStatus( owner: string, repo: string, pullNumber: number ): Promise<z.infer<typeof CombinedStatusSchema>> { // First get the PR to get the head SHA const pr = await getPullRequest(owner, repo, pullNumber); const sha = pr.head.sha; // Then get the combined status for that SHA const response = await githubRequest( `https://api.github.com/repos/${owner}/${repo}/commits/${sha}/status` ); return CombinedStatusSchema.parse(response); }
• operations/pulls.ts:137-141 (schema)

  Zod input schema defining parameters for the get_pull_request_status tool: owner, repo, pull_number.
  export const GetPullRequestStatusSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), pull_number: z.number().describe("Pull request number") });
• index.ts:181-183 (registration)

  Tool registration in the MCP server's list of tools, including name, description, and input schema reference.
  name: "get_pull_request_status", description: "Get the combined status of all status checks for a pull request", inputSchema: zodToJsonSchema(pulls.GetPullRequestStatusSchema)
• index.ts:541-547 (handler)

  MCP server router handler that parses arguments, calls the core getPullRequestStatus function, and formats the response.
  case "get_pull_request_status": { const args = pulls.GetPullRequestStatusSchema.parse(request.params.arguments); const status = await pulls.getPullRequestStatus(args.owner, args.repo, args.pull_number); return { content: [{ type: "text", text: JSON.stringify(status, null, 2) }], }; }