trading

The MCP server that will help you trade smarter (or at least try)

Installation

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

Run in terminal:

Command

claude mcp add --transport stdio netanelavr-trading-mcp node /path/to/trading-mcp/dist/server.js \
  --env OPENAI_API_KEY="sk-your-openai-api-key-here" \
  --env REDDIT_PASSWORD="your-reddit-password" \
  --env REDDIT_USERNAME="your-reddit-username" \
  --env REDDIT_CLIENT_ID="your-reddit-client-id" \
  --env REDDIT_CLIENT_SECRET="your-reddit-client-secret"

How to use

The Trading MCP Server provides an integrated suite of stock analysis tools accessible via MCP. It combines stock screening, fundamental metrics, insider activity, options sentiment, social media sentiment from Reddit, and news analysis to deliver comprehensive stock insights. After configuring your MCP client to load this server, you can call individual tools such as screen_stocks_advanced_filters for multi-criteria screening, get_fundamental_stock_metrics for detailed financials, analyze_insider_activity to monitor insider moves, get_put_call_ratio for options sentiment, discover_trending_stocks and analyze_reddit_sentiment for Reddit-based research, and analyze_news_and_market_context for AI-driven news impact analysis. The all-in-one comprehensive analysis tool, comprehensive_stock_analysis, stitches these data sources together to produce a holistic view of a stock.

How to install

Prerequisites:

Node.js (and npm) installed on your machine or hosting environment
Access to OpenAI API key and Reddit credentials if you plan to use OpenAI-powered analyses and Reddit-based features

Installation steps:

Clone the repository (or obtain the packaged server):

git clone <repository-url>
cd trading-mcp

Install dependencies:

npm install

Build the project (if a build step is required):

npm run build

Configure MCP client: Add the MCP configuration shown in the mcp_config section to your MCP client settings (for example in ~/.cursor/mcp.json). Ensure your environment variables (OPENAI_API_KEY, REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD) are set with valid credentials.
Run or deploy the server as appropriate for your environment. If you are using a bundler or deployment platform, point the command and path to the built server.js as shown in the mcp_config example.

Additional notes

Notes and tips:

OpenAI API access is required for news analysis and social sentiment analysis; Reddit access is required for social media features.
Do not expose your OpenAI API key or Reddit credentials in public configurations.
The server expects the path to the built server (dist/server.js) when using the provided Node command configuration.
If you switch to a different deployment method (e.g., Docker, pipx, etc.), align the mcp_config accordingly with the correct command and arguments.
Ensure network access to external APIs (OpenAI, Reddit) from the host running the MCP server.
For production, monitor API usage and implement rate limiting as needed to avoid overuse or throttling.

Related MCP Servers

ls

List MCP Server configurations in your system used by AI applications like Cursor, Claude Desktop, VS Code and others

mcpdog

🐕 Universal MCP Server Manager - Configure once, manage multiple MCP servers through a single interface. Perfect for Claude Desktop, Claude Code, Cursor, Gemini CLI & AI assistants. Web dashboard, auto-detection, unified proxy layer.

mongo

MCP server that provide tools to LLMs such as claude in cursor to interact with MongoDB

attio

Model Context Protocol server for Attio CRM - enables Claude Desktop and Cursor to interact with your Attio workspace

mermaid-live

MCP server from iishyfishyy/mermaid-live-mcp

companies-house

An unofficial Model Context Protocol (MCP) server for UK Companies House API providing company profiles, officer data, filing history, and comprehensive business intelligence with rate limiting and caching.