WSB Analyst MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/ferdousbhai-wsb-analyst-mcp-badge.png)](https://mseep.ai/app/ferdousbhai-wsb-analyst-mcp)
2 
3# WSB Analyst MCP Server
4 
5[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/ferdousbhai/wsb-analyst-mcp)](https://archestra.ai/mcp-catalog/ferdousbhai__wsb-analyst-mcp)
6[![smithery badge](https://smithery.ai/badge/@ferdousbhai/wsb-analyst-mcp)](https://smithery.ai/server/@ferdousbhai/wsb-analyst-mcp)
7 
8A Model Context Protocol (MCP) server that provides real-time WallStreetBets data for analysis with Claude or other LLM clients.
9 
10<a href="https://glama.ai/mcp/servers/@ferdousbhai/wsb-analyst-mcp">
11  <img width="380" height="200" src="https://glama.ai/mcp/servers/@ferdousbhai/wsb-analyst-mcp/badge" alt="WSB Analyst Server MCP server" />
12</a>
13 
14## Features
15 
16- **Fetch WallStreetBets Posts**: Filter posts by score, comment count, and content type
17- **Detailed Post Analysis**: Extract comments, links, and metadata from posts
18- **External Link Collection**: Gather links being shared in WSB discussions
19- **Analysis Templates**: Ready-to-use prompt templates for market analysis
20- **Progress Reporting**: Real-time progress updates during data collection
21- **MCP Integration**: Seamless integration with Claude Desktop and other MCP clients
22 
23## Requirements
24 
25- Python 3.12 or higher
26- Reddit API credentials
27- [Claude Desktop](https://claude.ai/download) or another MCP client
28 
29## Installation
30 
31### Installing via Smithery
32 
33To install WSB Analyst for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ferdousbhai/wsb-analyst-mcp):
34 
35```bash
36npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude
37```
38 
39Clone this repository or download the source files:
40 
41```bash
42git clone https://github.com/ferdousbhai/wsb-analyst-mcp
43cd wsb-analyst-mcp
44```
45 
46Create a virtual environment and install dependencies:
47 
48```bash
49# Using uv (recommended)
50uv sync
51```
52 
53## Setting Up Reddit API Credentials
54 
55To use this server, you need to create a Reddit application to get API credentials:
56 
571. Log in to your Reddit account
582. Navigate to [https://www.reddit.com/prefs/apps](https://www.reddit.com/prefs/apps)
593. Scroll down and click "create another app..." or "create an app..."
604. Fill in the following details:
61   - **name**: WSB Analyst MCP (or any name you prefer)
62   - **app type**: select "script"
63   - **description**: Optional description of your application
64   - **about url**: Can be left blank
65   - **redirect uri**: Use `http://localhost:8000` (any valid URL works as we don't use OAuth)
665. Click "create app"
676. After creation, note down:
68   - **client_id**: The string under the app name (appears right under "personal use script")
69   - **client_secret**: The string labeled "secret"
70 
71## Configuration for Claude Desktop
72 
73Open Claude Desktop's configuration file:
74 
75- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
76- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
77 
78Add the following configuration (adjust paths as needed):
79 
80```json
81{
82  "mcpServers": {
83    "wsb-analyst": {
84      "command": "uvx",
85      "args": [
86        "run",
87        "wsb-analyst"
88      ],
89      "env": {
90        "REDDIT_CLIENT_ID": "your_client_id_here",
91        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
92      }
93    }
94  }
95}
96```
97 
98Restart Claude Desktop
99 
100## Using with Claude Desktop
101 
102Once configured, you can interact with the WSB Analyst server through Claude:
103 
1041. Open Claude Desktop
1052. You should see a hammer icon in the bottom right corner of the message input box
1063. Click the hammer to see available tools
1074. Access prompt templates via slash commands (e.g., `/analyze_wsb_market`)
108 
109Example queries:
110 
111- "What are the top trending stocks on WallStreetBets today?"
112- "Analyze recent WallStreetBets posts and tell me about potential market opportunities"
113- "What external resources are WSB users sharing about AMD stock?"
114 
115## Available Tools
116 
117### `find_top_posts`
118 
119Fetch and filter WSB posts based on criteria.
120 
121Parameters:
122 
123- `min_score` (default: 100): Minimum score (upvotes) required
124- `min_comments` (default: 10): Minimum number of comments required
125- `limit` (default: 10): Maximum number of posts to return
126- `excluded_flairs` (default: `["Meme", "Shitpost", "Gain", "Loss"]`): List of post flairs to exclude.
127 
128### `fetch_post_details`
129 
130Fetch detailed information about a specific WSB post including top comments.
131 
132Parameters:
133 
134- `post_id`: Reddit post ID
135 
136### `fetch_batch_post_details`
137 
138Fetches details for multiple posts efficiently.
139 
140### `fetch_detailed_wsb_posts`
141 
142Fetch and filter WSB posts, then get detailed information including top comments and links for each.
143 
144### `get_external_links`
145 
146Collects all external links from top posts.
147 
148### `get_trending_tickers`
149 
150Identifies and returns a list of stock tickers frequently mentioned or discussed in recent top WSB posts.
151 
152## Prompt Templates
153 
154### `/analyze_wsb_market`
155 
156Provides a template prompt to guide an LLM in performing a comprehensive market analysis using the available tools (`fetch_detailed_wsb_posts`, `get_external_links`). It instructs the LLM on the structure and focus of the analysis.
157 
158### `/find_market_movers`
159 
160Creates a prompt focused on what's moving specific stocks or the overall market. This prompt guides the LLM to use tools like `find_top_posts` and `fetch_post_details` or `fetch_batch_post_details`.
161 
162## Integrating with Firecrawl MCP Server
163 
164For enhanced analysis capabilities, especially when dealing with external links found in WSB posts, you can integrate this server with the [Firecrawl MCP Server](https://github.com/mendableai/firecrawl-mcp-server). This allows your LLM agent to not only identify links shared on WSB but also scrape and analyze the content of those linked pages.
165 
166## License
167 
168MIT