trading-mcp

Overview

The Trading MCP server is a comprehensive finance-focused MCP implementation that integrates multiple data sources for stock analysis. It provides tools for technical screening, fundamental metrics comparison, insider trading monitoring, options sentiment analysis, and social media research with Reddit integration. The server requires external API keys from OpenAI and Reddit for advanced features like sentiment analysis.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• screen_stocks_advanced_filtersfilters: object, limit?: number

  Advanced stock screening using Finviz filters with technical patterns and fundamental criteria.

  Try:Find large-cap stocks with channel down patternsTry:Screen for profitable companies with low P/E ratios
• get_fundamental_stock_metricsticker: string, metrics?: array

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

  Try:Get fundamental metrics for AAPLTry:Show PEG and price-to-book ratios for MSFT
• compare_stock_valuationstickers: array, metrics?: array

  Compares valuation metrics across multiple stocks to identify relative value opportunities.

  Try:Compare valuations of AAPL, MSFT, and GOOGLTry:Show forward P/E ratios for tech stocks
• calculate_financial_health_scoreticker: string, weights?: object

  Calculates a comprehensive financial health score based on profitability, liquidity, leverage, and growth metrics.

  Try:Calculate financial health score for TSLATry:Show health score for JNJ with custom weights
• analyze_insider_activityticker: string, limit?: number, transaction_types?: array, analysis_period?: number, min_transaction_value?: number

  Monitors insider transactions and analyzes sentiment patterns with confidence scores.

  Try:Analyze insider trading for NVDATry:Show recent insider purchases for META over $100k
• get_put_call_ratioticker: string

  Retrieves put/call ratio data from Barchart to assess options market sentiment.

  Try:Get put/call ratio for SPYTry:Show options sentiment for QQQ
• comprehensive_stock_analysisticker: string

  All-in-one stock analysis combining fundamental metrics, financial health, insider data, options sentiment, and social/news analysis.

  Try:Comprehensive analysis of AMZNTry:Full analysis of BRK.B with all available data
• discover_trending_stockssubreddits?: array, limit?: number

  Identifies stocks gaining attention across Reddit investing communities with mention frequency.

  Try:Find trending stocks on wallstreetbetsTry:Show stocks with high mention volume in investing subreddits
• analyze_reddit_sentimentticker: string, subreddits?: array, time_filter?: string, limit?: number, sort?: string, max_posts_for_sentiment?: number, include_comments?: boolean, post_id_for_comments?: string, comment_limit?: number

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

  Try:Analyze Reddit sentiment for GMETry:Show sentiment for TSLA from past month with comments
• analyze_news_and_market_contextticker: string, days_back?: number, max_articles?: number, include_sentiment?: boolean, sector?: string, news_items?: array

  Combines news sentiment analysis, market impact assessment, and sector context analysis.

  Try:Analyze news for META from last 7 daysTry:Show market impact of recent news about TSLA

Comparable tools

Installation

git clone <repository-url>
cd trading-mcp
npm install

npm run build

{
  "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"
      }
    }
  }
}

FAQ

What API keys are required?

OpenAI API key is required for news analysis and social sentiment analysis. Reddit credentials are required for social media research features.

How can I get Reddit API credentials?

Visit Reddit App Preferences (https://www.reddit.com/prefs/apps), create a script app, and note your client_id and client_secret. Add these to your MCP configuration.

Compare trading-mcp with