Content
[](https://mseep.ai/app/ferdousbhai-wsb-analyst-mcp)
# WSB Analyst MCP Server
[](https://archestra.ai/mcp-catalog/ferdousbhai__wsb-analyst-mcp)
[](https://smithery.ai/server/@ferdousbhai/wsb-analyst-mcp)
A Model Context Protocol (MCP) server that provides real-time WallStreetBets data for analysis with Claude or other LLM clients.
<a href="https://glama.ai/mcp/servers/@ferdousbhai/wsb-analyst-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@ferdousbhai/wsb-analyst-mcp/badge" alt="WSB Analyst Server MCP server" />
</a>
## 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](https://claude.ai/download) or another MCP client
## Installation
### Installing via Smithery
To install WSB Analyst for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ferdousbhai/wsb-analyst-mcp):
```bash
npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude
```
Clone this repository or download the source files:
```bash
git clone https://github.com/ferdousbhai/wsb-analyst-mcp
cd wsb-analyst-mcp
```
Create a virtual environment and install dependencies:
```bash
# Using uv (recommended)
uv sync
```
## 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](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):
```json
{
"mcpServers": {
"wsb-analyst": {
"command": "uvx",
"args": [
"run",
"wsb-analyst"
],
"env": {
"REDDIT_CLIENT_ID": "your_client_id_here",
"REDDIT_CLIENT_SECRET": "your_client_secret_here"
}
}
}
}
```
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.
### `fetch_post_details`
Fetch detailed information about a specific WSB post including top comments.
Parameters:
- `post_id`: Reddit post ID
### `fetch_batch_post_details`
Fetches details for multiple posts efficiently.
### `fetch_detailed_wsb_posts`
Fetch and filter WSB posts, then get detailed information including top comments and links for each.
### `get_external_links`
Collects all external links from top posts.
### `get_trending_tickers`
Identifies and returns a list of stock tickers frequently mentioned or discussed in recent top WSB posts.
## Prompt Templates
### `/analyze_wsb_market`
Provides 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.
### `/find_market_movers`
Creates 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`.
## Integrating with Firecrawl MCP Server
For 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.
## License
MIT
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
markitdown
Python tool for converting files and office documents to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
mempalace
The highest-scoring AI memory system ever benchmarked. And it's free.
mempalace
The highest-scoring AI memory system ever benchmarked. And it's free.