Skip to main content
Glama
Trading MCP Server

Trading MCP Server

Trading MCP Server

A comprehensive Model Context Protocol (MCP) server for stock analysis and trading insights. This server provides advanced stock screening, fundamental analysis, insider trading data, social media sentiment, and news analysis capabilities.

🎬 Demo

https://github.com/user-attachments/assets/71995014-7cbb-48fa-80fb-f1f6d22fc91c

See the Trading MCP Server in action - from stock screening to comprehensive analysis

Related MCP server: Financial Modeling Prep (FMP) MCP Server

πŸ“‹ MCP Configuration

Add this to your MCP configuration file (typically ~/.cursor/mcp.json or your IDE's MCP settings):

{
  "mcpServers": {
    "trading-mcp": {
      "command": "node",
      "args": ["/path/to/trading-mcp/dist/server.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-openai-api-key-here",
        "REDDIT_CLIENT_ID": "your-reddit-client-id",
        "REDDIT_CLIENT_SECRET": "your-reddit-client-secret",
        "REDDIT_USERNAME": "your-reddit-username",
        "REDDIT_PASSWORD": "your-reddit-password"
      }
    }
  }
}

πŸš€ Features

  • πŸ“Š Stock Screening: Technical pattern recognition and advanced multi-criteria filtering

  • πŸ“ˆ Fundamental Analysis: Comprehensive metrics, valuation comparison, and AI health scoring

  • 🏒 Insider Trading: Real-time insider activity tracking and sentiment analysis

  • πŸ“Š Options Analysis: Put/call ratio data and options market sentiment analysis

  • πŸ’­ Social Media Research: Reddit integration with AI-powered sentiment analysis

  • πŸ“° News Analysis: AI-curated news with market impact assessment

  • 🎯 Comprehensive Analysis: All-in-one stock analysis combining multiple data sources

πŸ“š Available Tools

Note:

  • OpenAI API key is required for news analysis and social sentiment analysis

  • Reddit credentials are required for social media research features

Stock Screening Tools

screen_stocks_advanced_filters

Advanced stock screening using Finviz filters with support for technical patterns, fundamental criteria, and multi-parameter filtering. Returns stocks matching specific criteria with key metrics.

Parameters:

  • filters (object): Finviz format filters. Use "f" for basic filters, "o" for ordering. Example: {"f": "cap_large,fa_pe_profitable,ta_pattern_channeldown", "o": "marketcap"}

  • limit (number, default: 50): Maximum results to return

Fundamental Analysis Tools

get_fundamental_stock_metrics

Retrieves comprehensive financial metrics including P/E ratios, PEG, ROE, debt ratios, growth rates, and profitability margins.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • metrics (array, optional): Specific metrics to retrieve (returns all if not specified)

compare_stock_valuations

Compares valuation metrics across multiple stocks to identify relative value opportunities. Perfect for peer analysis and sector comparisons.

Parameters:

  • tickers (array, required): Stock ticker symbols to compare

  • metrics (array, default: ['pe', 'forwardPE', 'peg', 'priceToBook']): Valuation metrics to compare

calculate_financial_health_score

Calculates a comprehensive financial health score (0-100) based on profitability, liquidity, leverage, efficiency, and growth metrics with customizable weightings.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • weights (object, optional): Custom weights for health factors

    • profitability (default: 0.3), liquidity (default: 0.2), leverage (default: 0.2), efficiency (default: 0.15), growth (default: 0.15)

Insider Trading Tools

analyze_insider_activity

Monitors insider transactions and analyzes sentiment patterns. Returns transaction history with sentiment analysis and confidence scores.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • limit (number, default: 10): Maximum transactions to return

  • transaction_types (array, optional): Filter by transaction types

  • analysis_period (number, default: 90): Analysis period in days

  • min_transaction_value (number, default: 10000): Minimum transaction value threshold

Options Analysis Tools

get_put_call_ratio

Retrieves put/call ratio data from Barchart to assess options market sentiment. Returns ratios by expiration with sentiment analysis.

Parameters:

  • ticker (string, required): Stock ticker symbol

Comprehensive Analysis Tools

comprehensive_stock_analysis

All-in-one stock analysis combining fundamental metrics, financial health scoring, insider analysis, options sentiment, news analysis, and social sentiment when configured.

Parameters:

  • ticker (string, required): Stock ticker symbol to analyze

Social Media Research Tools

Requires Reddit API configuration

Identifies stocks gaining attention across Reddit investing communities. Returns trending tickers with mention frequency and engagement metrics.

Parameters:

  • subreddits (array, default: ['wallstreetbets', 'stocks']): Subreddits to analyze

  • limit (number, default: 20): Maximum trending tickers to return

analyze_reddit_sentiment

Requires both Reddit and OpenAI APIs

Searches Reddit discussions and uses AI to analyze retail investor sentiment. Returns posts with sentiment analysis and confidence scores.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • subreddits (array, default: ['stocks', 'wallstreetbets', 'investing', 'ValueInvesting']): Subreddits to search

  • time_filter (string, default: 'week'): Time period ('hour', 'day', 'week', 'month', 'year')

  • limit (number, default: 25): Maximum posts to retrieve

  • sort (string, default: 'hot'): Sort order ('relevance', 'hot', 'top', 'new')

  • max_posts_for_sentiment (number, default: 50): Posts to use for sentiment analysis

  • include_comments (boolean, default: false): Include comments from specific post

  • post_id_for_comments (string, optional): Post ID for comment retrieval

  • comment_limit (number, default: 100): Maximum comments if including comments

News Analysis Tools

Requires OpenAI API configuration

analyze_news_and_market_context

Combines news sentiment analysis, market impact assessment, and sector context analysis. Returns analyzed articles with sentiment scores and market predictions.

Parameters:

  • ticker (string, required): Stock ticker symbol

  • days_back (number, default: 7): Days to look back for news

  • max_articles (number, default: 10): Maximum articles to analyze

  • include_sentiment (boolean, default: true): Include sentiment analysis

  • sector (string, optional): Stock sector for enhanced context

  • news_items (array, optional): Specific headlines to analyze

πŸ› οΈ Installation & Setup

Installation

  1. Clone and install dependencies:

git clone <repository-url>
cd trading-mcp
npm install
  1. Build the project:

npm run build
  1. Configure in your MCP client: Add the MCP configuration shown above to your MCP client settings with your API credentials.

πŸ”§ Configuration

Required APIs

  • OpenAI: Required for news analysis and social sentiment analysis

  • Reddit: Required for social media research features

Getting API Keys

OpenAI API Key

  1. Visit OpenAI API

  2. Create an account or sign in

  3. Generate a new API key

  4. Add to your MCP configuration as OPENAI_API_KEY

Reddit API Credentials

  1. Visit Reddit App Preferences

  2. Click "Create App" or "Create Another App"

  3. Choose "script" as the app type

  4. Use a dummy redirect URI such as http://localhost:8080

  5. Note your client_id and client_secret

  6. Add your Reddit credentials to your MCP configuration

πŸ—οΈ Architecture

trading-mcp/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ server.ts          # Main MCP server
β”‚   β”œβ”€β”€ config.ts          # Configuration management
β”‚   β”œβ”€β”€ types/             # TypeScript interfaces
β”‚   β”‚   └── index.ts
β”‚   β”œβ”€β”€ adapters/          # External API adapters
β”‚   β”‚   β”œβ”€β”€ finviz.ts      # Finviz web scraping
β”‚   β”‚   β”œβ”€β”€ barchart.ts    # Barchart options data scraping
β”‚   β”‚   β”œβ”€β”€ reddit.ts      # Reddit API integration
β”‚   β”‚   └── openai.ts      # OpenAI API integration
β”‚   └── tools/             # Tool implementations
β”‚       β”œβ”€β”€ screening.ts   # Stock screening tools
β”‚       β”œβ”€β”€ fundamentals.ts # Fundamental analysis
β”‚       β”œβ”€β”€ insider.ts     # Insider trading analysis
β”‚       β”œβ”€β”€ options.ts     # Options analysis tools
β”‚       β”œβ”€β”€ social.ts      # Social media research
β”‚       β”œβ”€β”€ news.ts        # News analysis
β”‚       └── comprehensive.ts # Comprehensive analysis
β”œβ”€β”€ dist/                  # Compiled JavaScript
β”œβ”€β”€ package.json
β”œβ”€β”€ tsconfig.json
└── README.md

πŸ› Known Issues

  • Finviz web scraping may occasionally fail due to rate limiting or site changes

  • Barchart web scraping may occasionally fail due to site changes or rate limiting

  • Reddit API has rate limits that may affect high-volume usage

  • OpenAI API usage incurs costs based on tokens consumed

πŸ“Š Example Usage

Once configured, you can use the tools through your MCP-enabled client:

# Screen for stocks with specific technical patterns
Use screen_stocks_advanced_filters with filters: {"f": "ta_pattern_channeldown,cap_large,geo_usa"}

# Get comprehensive fundamental analysis
Use get_fundamental_stock_metrics for "AAPL" to see detailed financial data

# Compare multiple stocks
Use compare_stock_valuations for ["AAPL", "MSFT", "GOOGL"] to compare valuations

# Calculate financial health score
Use calculate_financial_health_score for "TSLA" to get AI-powered health assessment

# Analyze insider activity
Use analyze_insider_activity for "NVDA" to see insider trading patterns and sentiment

# Get options market sentiment
Use get_put_call_ratio for "SPY" to see put/call ratios and options sentiment

# Comprehensive analysis (all-in-one)
Use comprehensive_stock_analysis for "AMZN" to get complete multi-dimensional analysis

# Analyze social sentiment (requires Reddit + OpenAI)
Use analyze_reddit_sentiment for "GME" to see Reddit community sentiment

# Get trending stocks (requires Reddit)
Use discover_trending_stocks to find stocks gaining social media momentum

# Analyze news and market context (requires OpenAI)
Use analyze_news_and_market_context for "META" to get news analysis and market context

⚠️ Disclaimer

This software is for educational and research purposes only. It is not intended as financial advice. Always do your own research and consider consulting with a qualified financial advisor before making investment decisions.

The data provided by this server comes from third-party sources and may not always be accurate or up-to-date. Users should verify information independently before making any trading decisions.

Stock trading and investing involves risk, including the potential loss of principal. Past performance does not guarantee future results.


For questions or support, please open an issue on GitHub.

Available Tools

10 tools
analyze_insider_activityA

Comprehensive insider trading analysis tool that monitors recent transactions and analyzes sentiment patterns. Retrieves buy/sell activity by executives, directors, and major shareholders, then evaluates trading patterns to determine overall insider confidence (bullish, bearish, neutral). Returns detailed transaction history with sentiment analysis, confidence scores, and key insights about insider motivation. Essential for identifying stocks with strong insider support or potential red flags.

Inputs: ticker (required), limit, transaction_types, analysis_period, +1 more.

analyze_news_and_market_contextA

Comprehensive news and market analysis tool that combines recent news sentiment analysis, market impact assessment, and broader sector context analysis. Use this when researching current events affecting a stock, evaluating news-driven price movements, or understanding how individual stocks fit into current market trends. Returns analyzed articles with sentiment scores, impact predictions, sector performance analysis, and macroeconomic context. Essential for making informed investment decisions based on current market conditions.

Inputs: ticker (required), days_back, max_articles, include_sentiment, +2 more.

analyze_reddit_sentimentA

Comprehensive Reddit sentiment analysis tool that searches for stock discussions across multiple investing subreddits and uses AI to analyze retail investor sentiment. Combines Reddit post search, optional comment extraction, and advanced sentiment classification to gauge community opinion and engagement. Use this when assessing retail investor sentiment, detecting sentiment shifts, or validating investment decisions against community consensus. Returns posts, sentiment analysis with confidence scores, key themes, and community engagement metrics.

Inputs: ticker (required), subreddits, time_filter, limit, +5 more.

calculate_financial_health_scoreA

Financial health analysis tool that calculates a comprehensive score based on profitability, liquidity, leverage, efficiency, and growth metrics. Use this when evaluating the overall financial strength of a company for investment decisions, risk assessment, or portfolio screening. Returns a weighted health score (0-100) with detailed breakdowns of each category, component analysis, and actionable insights. Allows custom weighting of different financial factors to match your investment strategy.

Inputs: ticker (required), weights.

compare_stock_valuationsA

Relative valuation analysis tool that compares key valuation metrics across multiple stocks to identify undervalued or overvalued opportunities. Use this when performing peer analysis, sector comparisons, or evaluating multiple investment candidates side-by-side. The tool returns a comparative analysis with P/E, PEG, Price-to-Book ratios and highlights relative value opportunities. Essential for making informed investment decisions based on relative attractiveness.

Inputs: tickers (required), metrics.

comprehensive_stock_analysisA

Ultimate comprehensive stock analysis tool that combines multiple analyses in parallel to provide a complete investment evaluation. Executes fundamental metrics, financial health scoring, insider trading analysis, put/call ratio analysis, and when configured, news analysis and Reddit sentiment analysis. Use this when you need a complete overview of a stock across all analysis dimensions for investment decision-making. Returns a formatted report with all analysis results, key insights, and investment summary.

Inputs: ticker (required).

get_fundamental_stock_metricsA

Comprehensive fundamental analysis tool that retrieves detailed financial metrics including P/E ratios, PEG, ROE, debt ratios, growth rates, and profitability margins. Use this when conducting deep fundamental analysis of individual stocks for investment decisions or valuation assessments. The tool returns complete financial data with key ratios, growth metrics, and profitability indicators. Supports selective metric retrieval for targeted analysis.

Inputs: ticker (required), metrics.

get_put_call_ratioA

Options market analysis tool that retrieves put/call ratio data from Barchart to assess market sentiment and options flow. Use this when analyzing options market sentiment, detecting potential market reversals, or understanding institutional hedging activity. The tool returns comprehensive put/call ratios for different expiration dates, volume and open interest data, and AI-powered sentiment analysis. Higher put/call ratios typically indicate bearish sentiment, while lower ratios suggest bullish sentiment. Essential for options traders and investors looking to gauge market sentiment.

Inputs: ticker (required).

screen_stocks_advanced_filtersA

Comprehensive stock screening using Finviz filters that supports technical patterns, fundamental criteria, and multi-parameter filtering. Use this when you need to find stocks matching specific investment criteria like channel down patterns, profitable companies, or large-cap stocks. The tool returns a ranked list of stocks with key metrics including market cap, P/E ratios, and current prices. Supports complex filter combinations for advanced screening strategies using Finviz format parameters.

Inputs: filters, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 10 tools

    Disambiguation4/5

    Each tool targets a specific analysis domain (insider, news, Reddit, fundamentals, etc.), but there is slight overlap between analyze_reddit_sentiment and discover_trending_stocks (both use Reddit), and comprehensive_stock_analysis duplicates the functionality of many individual tools. Nonetheless, the descriptions clearly differentiate their purposes.

    Naming Consistency4/5

    All tools use snake_case with action verbs (analyze, calculate, compare, discover, get, screen). There is one outlier (comprehensive_stock_analysis) that uses a phrase rather than verb_noun, but the pattern is mostly consistent.

    Tool Count5/5

    10 tools is well-scoped for a trading analysis server. Each tool provides a distinct function without being overwhelming, and the count aligns with typical MCP server sizes for this domain.

    Completeness4/5

    The tool set covers fundamental analysis, valuation, sentiment (news, Reddit, options), insider activity, screening, and trending detection. Missing technical analysis and risk metrics, but overall it's a robust coverage for a stock analysis server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.
      17
      51
      Python
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides comprehensive access to real-time stock quotes, financial statements, analyst estimates, and technical indicators via the Financial Modeling Prep API. It enables users to conduct in-depth financial analysis and track market performance through specialized tools, resources, and prompt templates.
      26
      47 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Comprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.
      26
      9 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A free MCP server for stock research combining Finviz screening and SEC EDGAR filings, offering 24 tools for fundamental analysis, insider trades, and financial data without paid subscriptions.
      24
      MIT