Wsb Analyst MCP

What ferdousbhai/wsb-analyst-mcp MCP server does

ferdousbhai/wsb-analyst-mcp MCP server exposes WallStreetBets data through the Model Context Protocol. It is intended for agents that need to inspect recent posts from the WallStreetBets subreddit and use that material as input for analysis. The server can filter posts using engagement criteria and exclude selected post flairs, then return additional context such as top comments, metadata, and links.

The project also includes prompt templates for market-analysis workflows. These templates guide an MCP client toward tasks such as reviewing recent WSB discussions or investigating what may be moving a particular stock or the broader market.

How it works

The server connects to Reddit using an application created in the user's Reddit account. The README specifies a script-type Reddit application and requires its client ID and client secret. OAuth is not used; a redirect URI is still entered when creating the Reddit application, but the server does not use OAuth for access.

After the server is configured in an MCP client, the client can call tools to retrieve posts and related information. A typical workflow starts by finding high-engagement posts, then retrieving individual or batched details. A combined tool can perform filtering and detailed retrieval in one operation. Other workflows collect external links or identify stock tickers frequently discussed in recent top posts.

Setup and configuration

The documented requirements are Python 3.12 or newer, Reddit API credentials, and Claude Desktop or another MCP-compatible client. The repository can be cloned and its dependencies installed with uv sync.

For Claude Desktop, the README shows a local uvx configuration using run and wsb-analyst, with these environment variables:

• REDDIT_CLIENT_ID: the Reddit application's client ID.
• REDDIT_CLIENT_SECRET: the Reddit application's client secret.

The configuration file is located under the Claude application-support directory on macOS and under %APPDATA%\\Claude on Windows. Claude Desktop must be restarted after the MCP server entry is added. The repository also documents installation through Smithery, but that is an installer path rather than the server's own runtime command.

Tools and capabilities

Available MCP tools include:

• find_top_posts, which filters posts by minimum score, minimum comment count, result limit, and excluded flairs. The documented defaults are 100 score, 10 comments, a limit of 10, and exclusions for Meme, Shitpost, Gain, and Loss.
• fetch_post_details, which accepts a Reddit post ID and returns detailed post information including top comments.
• fetch_batch_post_details, which retrieves details for multiple posts.
• fetch_detailed_wsb_posts, which combines post filtering with detailed results, top comments, and links.
• get_external_links, which collects external links from top posts.
• get_trending_tickers, which returns stock tickers frequently mentioned or discussed in recent top posts.

The server reports progress during data collection and exposes prompt templates named /analyze_wsb_market and /find_market_movers.

Limitations and notes

Results depend on Reddit API access and the configured filtering criteria. The tools analyze WallStreetBets content; they do not provide an independent source of financial research or validate claims made in posts. External pages linked from WSB are collected but are not automatically scraped by this server. The README suggests pairing it with Firecrawl MCP when linked-page scraping and analysis are needed. The project is licensed under MIT.