wsb-analyst-mcp

Purpose

wsb-analyst-mcp is a Model Context Protocol (MCP) server designed to provide Claude or other LLM clients with real-time data from the Reddit WallStreetBets (WSB) community for market analysis and discussion tracking. It connects WSB data to LLMs through the MCP protocol, enabling models to directly query, filter, and analyze post content.

Main Capabilities

• Fetch WSB posts: Supports filtering by score (min_score), number of comments (min_comments), return count (limit), and excluded flairs (excluded_flairs).
• Detailed post analysis: Can extract comments, links, and metadata for specified posts.
• Batch post details: Efficiently fetch detailed information for multiple posts.
• External link collection: Collect all external links from popular posts.
• Trending ticker identification: Returns a list of stock tickers frequently mentioned in recent popular WSB posts.
• Analysis templates: Provides ready-to-use prompt templates (such as /analyze_wsb_market, /find_market_movers) to guide LLMs in market analysis.
• Progress reporting: Provides real-time progress updates during data collection.
• MCP integration: Seamlessly integrates with Claude Desktop and other MCP clients.

Usage

Environment Requirements

• Python 3.12 or later
• Reddit API credentials
• Claude Desktop or another MCP client

Installation

• Can be automatically installed to Claude Desktop via Smithery.
• You can also manually clone the repository or download the source files, create a virtual environment, and install dependencies.

Configure Reddit API Credentials

1. Log in to your Reddit account.
2. Visit https://www.reddit.com/prefs/apps。
3. Click "create another app..." or "create an app...".
4. Fill in: name (e.g., WSB Analyst MCP), select "script" for app type, description is optional, about url can be left blank, redirect uri uses http://localhost:8000。
5. Click "create app".
6. Record the client_id (the string below the app name) and client_secret (the string marked as "secret").

Configure Claude Desktop

• Open the configuration file: on macOS the path is ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows the path is %APPDATA%\Claude\claude_desktop_config.json.
• Add the corresponding configuration (paths need to be adjusted).
• Restart Claude Desktop.

Use in Claude Desktop

• Open Claude Desktop, and a hammer icon will appear in the lower-right corner of the message input box.
• Click the hammer to view available tools.
• Access prompt templates via slash commands (such as /analyze_wsb_market).
• Example queries: "What are the top trending stocks on WallStreetBets today?", "Analyze recent WallStreetBets posts and tell me about potential market opportunities", "What external resources are WSB users sharing about AMD stock?"

Available Tools

• fetch_top_posts: Fetch and filter WSB posts by criteria. Parameters: min_score (default 100), min_comments (default 10), limit (default 10), excluded_flairs (default ["Meme", "Shitpost", "Gain", "Loss"]).
• fetch_post_details: Fetch detailed information for a specific post, including top comments. Parameters: post_id.
• fetch_batch_post_details: Efficiently fetch details for multiple posts.
• fetch_detailed_wsb_posts: Retrieve and filter posts, then get detailed information for each post (including top comments and links).
• get_external_links: Collect all external links from top posts.
• get_trending_tickers: Identify and return a list of stock tickers frequently mentioned in recent popular WSB posts.

Prompt Templates

• /analyze_wsb_market: Provides a template prompt that guides the LLM to use the available tools (fetch_detailed_wsb_posts, get_external_links) for comprehensive market analysis, and explains the structure and focus of the analysis.
• /find_market_movers: Creates prompts focused on specific stocks or overall market movements, guiding the LLM to use tools such as find_top_posts and fetch_post_details or fetch_batch_post_details.

Integration with Firecrawl MCP Server

To enhance analytical capabilities, especially when handling external links in WSB posts, this server can be integrated with the Firecrawl MCP Server. This allows the LLM agent to not only identify links shared on WSB, but also scrape and analyze the content of the linked pages.

Use Cases

• Financial analysis: Track popular stocks and market sentiment in the WallStreetBets community.
• Market research: Analyze discussion trends, external links, and stock tickers in posts.
• LLM enhancement: Provide real-time WSB data for models such as Claude, expanding their financial domain knowledge.

Limitations

• Users need to apply for Reddit API credentials themselves and configure them.
• Depends on Python 3.12+ and an MCP client (such as Claude Desktop).
• Use must comply with the Reddit API terms and the MCP protocol.
• Specific fees, pricing, platform compatibility, etc. are not provided in the materials.