Reddit MCP Server

Instructions

Implementation Reference

• src/reddit-client.ts:150-153 (handler)

  Core handler function that authenticates, makes API request to Reddit for subreddit info, and maps the response to a structured RedditSubreddit object.

  async getSubredditInfo(subreddit: string): Promise<RedditSubreddit> {
    const data = await this.makeRequest(`/r/${subreddit}/about`);
    return this.mapSubreddit(data.data);
  }

• src/index.ts:53-55 (schema)

  Zod schema for validating input parameters (subreddit name) to the get_subreddit_info tool.

  const GetSubredditInfoSchema = z.object({
    subreddit: z.string().min(1, "Subreddit name is required"),
  });

• src/index.ts:150-163 (registration)

  Tool registration in the MCP server's listTools response, defining name, description, and input schema.

  {
    name: 'get_subreddit_info',
    description: 'Get information about a subreddit',
    inputSchema: {
      type: 'object',
      properties: {
        subreddit: {
          type: 'string',
          description: 'Name of the subreddit (without r/ prefix)',
        },
      },
      required: ['subreddit'],
    },
  },

• src/index.ts:335-346 (handler)

  MCP dispatch handler case that parses arguments using the schema, calls the RedditClient handler, and formats the JSON response.

  case 'get_subreddit_info': {
    const args = GetSubredditInfoSchema.parse(request.params.arguments);
    const subreddit = await redditClient.getSubredditInfo(args.subreddit);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(subreddit, null, 2),
        },
      ],
    };
  }

• src/reddit-client.ts:31-40 (schema)

  TypeScript interface defining the output structure for subreddit information returned by the handler.

  export interface RedditSubreddit {
    display_name: string;
    title: string;
    description: string;
    subscribers: number;
    created_utc: number;
    public_description: string;
    url: string;
    over18: boolean;
  }