GitHub Notifications MCP Server

Instructions

Implementation Reference

• src/tools/set-thread-subscription.ts:20-52 (handler)

  The main handler function that executes the tool logic: updates GitHub notification thread subscription via API call.

  export async function setThreadSubscriptionHandler(args: z.infer<typeof setThreadSubscriptionSchema>) {
    try {
      // Prepare request body
      const requestBody = {
        ignored: args.ignored
      };
  
      // Make request to GitHub API
      const subscription = await githubPut<ThreadSubscription>(
        `/notifications/threads/${args.thread_id}/subscription`, 
        requestBody
      );
  
      // Format the subscription for better readability
      const formattedSubscription = formatSubscription(subscription);
      const status = args.ignored ? "ignoring" : "subscribing to";
  
      return {
        content: [{
          type: "text",
          text: `Successfully updated subscription by ${status} thread ${args.thread_id}:\n\n${formattedSubscription}`
        }]
      };
    } catch (error) {
      return {
        isError: true,
        content: [{
          type: "text",
          text: formatError(`Failed to update subscription for thread ${args.thread_id}`, error)
        }]
      };
    }
  }

• src/tools/set-thread-subscription.ts:12-15 (schema)

  Zod schema defining input parameters for the tool: thread_id (string) and ignored (optional boolean).

  export const setThreadSubscriptionSchema = z.object({
    thread_id: z.string().describe("The ID of the notification thread to subscribe to"),
    ignored: z.boolean().optional().default(false).describe("If true, notifications will be ignored")
  });

• src/tools/set-thread-subscription.ts:57-64 (registration)

  Registration function that adds the tool to the MCP server using server.tool().

  export function registerSetThreadSubscriptionTool(server: any) {
    server.tool(
      "set-thread-subscription",
      "Subscribe to a GitHub notification thread",
      setThreadSubscriptionSchema.shape,
      setThreadSubscriptionHandler
    );
  }

• src/server.ts:44-44 (registration)

  Call to the registration function during MCP server startup to enable the tool.

  registerSetThreadSubscriptionTool(server);