ferdousbhai/investor-agent logo

ferdousbhai/investor-agent

Free

Yahoo Finance 集成,获取股市数据,包括期权推荐。

FreeFree tier
Type
Open Source

About ferdousbhai/investor-agent

Investor Agent is an open-source Model Context Protocol (MCP) server designed for long-term financial research. It provides a suite of tools for retrieving stock fundamentals, historical price data (OHLCV), options contracts sorted by open interest, market movers, upcoming earnings reports, the CNN Fear & Greed index, and technical indicators (SMA, EMA, RSI, MACD, Bollinger Bands). Built for integration with AI assistants like Claude, it can be run easily via npx and is licensed under MIT.

Key Features

get_stock_info: Retrieves stock fundamentals including price, financials, earnings, ownership, analyst ratings, and profile
historical_prices: Provides OHLCV price history (default: 1 year weekly, limit 100)
get_options: Returns options contracts sorted by open interest (default: top 25 per type)
market_movers: Lists top gaining, losing, or most active stocks
earnings_calendar: Displays upcoming earnings reports from NASDAQ
fear_greed_index: Fetches the CNN stock market or crypto Fear & Greed index
technical_indicator: Computes SMA, EMA, RSI, MACD, or Bollinger Bands

Pros & Cons

Pros
  • Free and open-source (MIT license)
  • Easy one-command setup via npx (no installation required)
  • Integrates seamlessly with MCP-compatible AI assistants (e.g., Claude)
  • Comprehensive coverage: fundamentals, history, options, movers, earnings, fear/greed, technical indicators
  • Actively maintained with 341 stars and 65 forks on GitHub
Cons
  • Data sources (Yahoo Finance, NASDAQ, CNN) may have latency or be limited to US markets
  • No built-in backtesting or portfolio management features
  • Requires an MCP host (e.g., Claude desktop or custom app) to interact with tools
  • Options data limited to top 25 per type by default (configurable via code)

Best For

Long-term equity research and fundamental analysisMonitoring stock market movers and sentiment indicatorsAnalyzing options market activity for investment decisionsTracking upcoming earnings reports for portfolio planningTechnical analysis of stock price trends

FAQ

What is investor-agent?
Investor-agent is an open-source Model Context Protocol (MCP) server that provides financial research tools for long-term investors. It can be used with AI assistants like Claude to fetch stock data and analysis.
How do I set up investor-agent?
Simply add the configuration to your MCP client (e.g., Claude desktop) with 'command': 'npx', 'args': ['-y', 'investor-agent']. No other setup required.
What data sources does investor-agent use?
It pulls data from Yahoo Finance (stock info, history, options, market movers), NASDAQ (earnings calendar), and CNN (fear & greed index). Technical indicators are computed locally.