reddit_explain

Instructions

Implementation Reference

• src/tools/index.ts:389-474 (handler)

  The main handler function for the 'reddit_explain' tool. It provides explanations for common Reddit terms using a predefined dictionary, returning structured data with definition, origin, usage, and examples.

  async redditExplain(params: z.infer<typeof redditExplainSchema>) {
    // This would ideally use a knowledge base, but we'll provide common explanations
    const explanations: Record<string, any> = {
      'karma': {
        definition: 'Reddit points earned from upvotes on posts and comments',
        origin: 'Concept from Hinduism/Buddhism adapted for Reddit\'s scoring system',
        usage: 'Users accumulate karma to show contribution quality',
        examples: ['High karma users are often trusted more', 'Some subreddits require minimum karma to post'],
      },
      'cake day': {
        definition: 'Anniversary of when a user joined Reddit',
        origin: 'Reddit displays a cake icon next to usernames on this day',
        usage: 'Users often get extra upvotes on their cake day',
        examples: ['Happy cake day!', 'It\'s my cake day, AMA'],
      },
      'ama': {
        definition: 'Ask Me Anything - Q&A session with interesting people',
        origin: 'Started in r/IAmA subreddit',
        usage: 'Celebrities, experts, or people with unique experiences answer questions',
        examples: ['I am Elon Musk, AMA', 'I survived a plane crash, AMA'],
      },
      'eli5': {
        definition: 'Explain Like I\'m 5 - request for simple explanation',
        origin: 'From r/explainlikeimfive subreddit',
        usage: 'Used when asking for complex topics to be explained simply',
        examples: ['ELI5: How does bitcoin work?', 'Can someone ELI5 quantum computing?'],
      },
      'til': {
        definition: 'Today I Learned - sharing interesting facts',
        origin: 'From r/todayilearned subreddit',
        usage: 'Prefix for sharing newly discovered information',
        examples: ['TIL bananas are berries', 'TIL about the Baader-Meinhof phenomenon'],
      },
      'op': {
        definition: 'Original Poster - person who created the post',
        origin: 'Common internet forum terminology',
        usage: 'Refers to the person who started the discussion',
        examples: ['OP delivers!', 'Waiting for OP to respond'],
      },
      'repost': {
        definition: 'Content that has been posted before',
        origin: 'Common issue on content aggregation sites',
        usage: 'Often called out by users who\'ve seen the content before',
        examples: ['This is a repost from last week', 'General Reposti!'],
      },
      'brigading': {
        definition: 'Coordinated effort to manipulate votes or harass',
        origin: 'Named after military brigade tactics',
        usage: 'Against Reddit rules, can result in bans',
        examples: ['Don\'t brigade other subs', 'This looks like brigading'],
      },
      '/s': {
        definition: 'Sarcasm indicator',
        origin: 'HTML-style closing tag for sarcasm',
        usage: 'Added to end of sarcastic comments to avoid misunderstanding',
        examples: ['Yeah, that\'s totally going to work /s', 'Great idea /s'],
      },
      'banana for scale': {
        definition: 'Using a banana to show size in photos',
        origin: 'Started as a Reddit meme in 2013',
        usage: 'Humorous way to provide size reference',
        examples: ['Found this rock, banana for scale', 'No banana for scale?'],
      },
    };
  
    const term = params.term.toLowerCase();
    const explanation = explanations[term];
  
    if (!explanation) {
      return {
        definition: 'Term not found in database. This might be a subreddit-specific term or newer slang.',
        origin: 'Unknown',
        usage: 'Try searching Reddit for this term to see how it\'s used',
        examples: [],
        relatedTerms: [],
      };
    }
  
    return {
      definition: explanation.definition,
      origin: explanation.origin,
      usage: explanation.usage,
      examples: explanation.examples,
      relatedTerms: [],
    };
  }

• src/tools/index.ts:50-52 (schema)

  Zod schema defining the input parameters for the reddit_explain tool: a single 'term' string.

  export const redditExplainSchema = z.object({
    term: z.string().describe('Reddit term to explain (e.g., "karma", "cake day", "AMA")'),
  });

• src/mcp-server.ts:130-135 (registration)

  Registers the 'reddit_explain' tool in the MCP server by defining its name, description, and input schema in the toolDefinitions array.

  {
    name: 'reddit_explain',
    description: 'Get explanations of Reddit terms, slang, and culture. Returns definition, origin, usage, and examples.',
    inputSchema: zodToJsonSchema(redditExplainSchema) as any,
    readOnlyHint: true
  }

• src/mcp-server.ts:171-175 (registration)

  Dispatch handler in the tool call switch statement that invokes the redditExplain method with parsed arguments.

  case 'reddit_explain':
    result = await tools.redditExplain(
      redditExplainSchema.parse(args)
    );
    break;