ferdousbhai/wsb-analyst-mcp

A Model Context Protocol (MCP) server that provides real-time WallStreetBets data for analysis with Claude or other LLM clients.
Features
- **Fetch WallStreetBets Posts**: Filter posts by score, comment count, and content type
- **Detailed Post Analysis**: Extract comments, links, and metadata from posts
- **External Link Collection**: Gather links being shared in WSB discussions
- **Analysis Templates**: Ready-to-use prompt templates for market analysis
- **Progress Reporting**: Real-time progress updates during data collection
- **MCP Integration**: Seamless integration with Claude Desktop and other MCP clients
Requirements
- Python 3.12 or higher
- Reddit API credentials
- Claude Desktop or another MCP client
Installation
Installing via Smithery
To install WSB Analyst for Claude Desktop automatically via Smithery:
Clone this repository or download the source files:
Create a virtual environment and install dependencies:
Setting Up Reddit API Credentials
To use this server, you need to create a Reddit application to get API credentials:
1. Log in to your Reddit account
2. Navigate to https://www.reddit.com/prefs/apps
3. Scroll down and click "create another app..." or "create an app..."
4. Fill in the following details:
- **name**: WSB Analyst MCP (or any name you prefer)
- **app type**: select "script"
- **description**: Optional description of your application
- **about url**: Can be left blank
- **redirect uri**: Use http://localhost:8000 (any valid URL works as we don't use OAuth)
5. Click "create app"
6. After creation, note down:
- **client_id**: The string under the app name (appears right under "personal use script")
- **client_secret**: The string labeled "secret"
Configuration for Claude Desktop
Open Claude Desktop's configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration (adjust paths as needed):
Restart Claude Desktop
Using with Claude Desktop
Once configured, you can interact with the WSB Analyst server through Claude:
1. Open Claude Desktop
2. You should see a hammer icon in the bottom right corner of the message input box
3. Click the hammer to see available tools
4. Access prompt templates via slash commands (e.g., /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
find_top_posts
Fetch and filter WSB posts based on criteria.
Parameters:
- min_score (default: 100): Minimum score (upvotes) required
- min_comments (default: 10): Minimum number of comments required
- limit (default: 10): Maximum number of posts to return
- excluded_flairs (default: ["Meme", "Shitpost", "Gain", "Loss"]): List of post flairs to exclude.