GitHub Notifications MCP Server

Instructions

Implementation Reference

• src/tools/get-thread-subscription.ts:19-51 (handler)

  The main handler function that executes the tool logic: fetches GitHub notification thread subscription status, formats it, and handles errors including 404 for unsubscribed threads.

  export async function getThreadSubscriptionHandler(args: z.infer<typeof getThreadSubscriptionSchema>) {
    try {
      // Make request to GitHub API
      const subscription = await githubGet<ThreadSubscription>(`/notifications/threads/${args.thread_id}/subscription`);
  
      // Format the subscription for better readability
      const formattedSubscription = formatSubscription(subscription);
  
      return {
        content: [{
          type: "text",
          text: `Subscription status for thread ${args.thread_id}:\n\n${formattedSubscription}`
        }]
      };
    } catch (error) {
      if (error instanceof Error && error.message.includes("404")) {
        return {
          content: [{
            type: "text",
            text: `You are not subscribed to thread ${args.thread_id}.`
          }]
        };
      }
      
      return {
        isError: true,
        content: [{
          type: "text",
          text: formatError(`Failed to fetch subscription for thread ${args.thread_id}`, error)
        }]
      };
    }
  }

• src/tools/get-thread-subscription.ts:12-14 (schema)

  Zod schema defining the input parameter: thread_id (string).

  export const getThreadSubscriptionSchema = z.object({
    thread_id: z.string().describe("The ID of the notification thread to check subscription status")
  });

• src/tools/get-thread-subscription.ts:56-63 (registration)

  The registration function that adds the tool to the MCP server using server.tool() with name, description, schema, and handler.

  export function registerGetThreadSubscriptionTool(server: any) {
    server.tool(
      "get-thread-subscription",
      "Get subscription status for a GitHub notification thread",
      getThreadSubscriptionSchema.shape,
      getThreadSubscriptionHandler
    );
  }

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

  Invocation of the registration function in the main server startup.

  registerGetThreadSubscriptionTool(server);