volume-wall-detector

Volume Wall Detector MCP delivers real-time stock volume analysis and imbalance tracking with MongoDB storage, powered by the open Model Context Protocol (MCP).

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio cognitive-stack-volume-wall-detector-mcp npx -y volume-wall-detector-mcp@latest \
  --env PORT="8080" \
  --env TIMEZONE="GMT+7" \
  --env PAGE_SIZE="50" \
  --env MONGO_HOST="localhost" \
  --env MONGO_PORT="27017" \
  --env MONGO_USER="admin" \
  --env API_BASE_URL="your-api-url-here" \
  --env DAYS_TO_FETCH="1" \
  --env MONGO_DATABASE="volume_wall_detector" \
  --env MONGO_PASSWORD="password" \
  --env TRANSPORT_TYPE="stdio" \
  --env TRADES_TO_FETCH="10000" \
  --env MONGO_AUTH_SOURCE="admin" \
  --env MONGO_AUTH_MECHANISM="SCRAM-SHA-1"

How to use

This MCP server provides real-time volume analysis for stock trading and helps detect volume walls, imbalances, and after-hours activity. It persists data in MongoDB and exposes a server endpoint that MCP clients can connect to for querying volume signals, trading activity, and persistence-backed insights. You can run it via NPX in any MCP client workflow, and you can customize its behavior with environment variables such as API_BASE_URL for market data access, MONGO_* for database connectivity, and PAGE_SIZE/TRADES_TO_FETCH to control data retrieval. When connected, clients can request latest volume wall detections, historical volumes, and trading imbalance indicators, as well as after-hours analyses.

How to install

Prerequisites:

MongoDB instance running
Access to a stock market API
Node.js v20 or higher
Git (optional for cloning or alternative install methods)

Install and run via NPX (recommended):

Ensure Node.js and npm are installed.
Run:

npx -y volume-wall-detector-mcp@latest

This pulls the latest MCP server package and starts it using NPX. You can customize runtime behavior with environment variables as shown in the MCP config (TIMEZONE, API_BASE_URL, MONGO_* settings, PAGE_SIZE, TRADES_TO_FETCH, DAYS_TO_FETCH, TRANSPORT_TYPE, PORT).

Alternative via Smithery (for Claude Desktop integration):

npx -y @smithery/cli install volume-wall-detector-mcp --client claude

If you use other MCP clients (Cline, Cursor, Claude Desktop), configure their MCP settings to point to the NPX command with the appropriate environment variables as described in the README examples.

Additional notes

Tips and notes:

Ensure MongoDB is reachable with the provided MONGO_HOST, MONGO_PORT, and credentials.
TIMEZONE should reflect the data source timezone to align trading hours.
API_BASE_URL must point to your market data provider.
If you encounter port conflicts, change PORT or bind to a suitable interface.
The transport type is set to stdio by default; adjust TRANSPORT_TYPE if your MCP client requires a different transport.
The configuration shown is compatible with Cline, Cursor, Claude Desktop, and other MCP clients; adjust per-client specifics if needed (e.g., different env or command wrapping).
For persistence, ensure the MongoDB database volume_wall_detector exists or will be created by the server with the provided credentials.
When upgrading, prefer the latest MCP package to benefit from new features and fixes.