MCP Directory

How to add WSB Analyst MCP Server to Windsurf

Real-time WallStreetBets (Reddit) data for market analysis with Claude and other LLM clients. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 27★ · stdio · apikey

Windsurf config for WSB Analyst MCP Server

npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude
{
  "mcpServers": {
    "wsb-analyst-mcp-server": {
      "command": "uvx",
      "args": [
        "run",
        "wsb-analyst"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the WSB Analyst MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5WSB Analyst MCP Server's tools become available to Cascade.

Before you start

  • Python 3.12 or higher
  • Reddit API credentials (client_id and client_secret from a 'script' type Reddit app)
  • Claude Desktop or another MCP client
  • uv (recommended for local install via 'uv sync')

What WSB Analyst MCP Server can do in Windsurf

find_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 about a specific WSB post including top comments. Parameter: 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.

Security

Requires Reddit API credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET) created as a 'script' type Reddit app. Store these secrets in your MCP client config; do not commit them. The server reads public WallStreetBets content and does not place trades or move money.

WSB Analyst MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the WSB Analyst MCP Server config there under the "mcpServers" key and restart the client.

Is WSB Analyst MCP Server safe to use with Windsurf?

Requires Reddit API credentials (REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET) created as a 'script' type Reddit app. Store these secrets in your MCP client config; do not commit them. The server reads public WallStreetBets content and does not place trades or move money.

What credentials do I need?

Reddit API credentials. Create a 'script' type app at https://www.reddit.com/prefs/apps, then use the client_id and client_secret as REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET. OAuth is not used, so any valid redirect URI (e.g. http://localhost:8000) works.

How do I install it for Claude Desktop?

The easiest path is Smithery: run `npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude`. Alternatively, clone the repo, run `uv sync`, and add the mcpServers block to your claude_desktop_config.json with your Reddit credentials.

Are there prompt templates included?

Yes. /analyze_wsb_market guides a comprehensive market analysis, and /find_market_movers focuses on what is moving specific stocks or the market. They are accessed via slash commands in the MCP client.

View repo Full WSB Analyst MCP Server page