Investor Agent

What ferdousbhai/investor-agent MCP server does

The ferdousbhai/investor-agent MCP server provides financial research tools for analyzing publicly available market information. Its data coverage includes stock fundamentals, price history, options contracts, market activity, upcoming earnings, market sentiment, and common technical indicators.

The server is designed for research workflows involving long-term investors. It does not document order placement, brokerage connectivity, portfolio tracking, or trade execution, so it should not be treated as a transactional trading interface.

How it works

Agents call the exposed MCP tools with the relevant stock, market, or indicator inputs. Historical price results use OHLCV data and default to one year of weekly observations, with a default limit of 100 records. Options are sorted by open interest and return up to 25 contracts per option type by default.

Market movers can report top gaining, losing, or most active stocks. The earnings calendar sources upcoming reports from NASDAQ. Sentiment requests can return either the CNN stock market Fear & Greed Index or its crypto counterpart. Technical analysis supports SMA, EMA, RSI, MACD, and Bollinger Bands.

Setup and configuration

The ferdousbhai/investor-agent MCP server can run locally with npx. Add it to an MCP client configuration using the following command and arguments:

{
  "mcpServers": {
    "investor-agent": {
      "command": "npx",
      "args": ["-y", "investor-agent"]
    }
  }
}

The repository also includes a Cloudflare Workers entry point at src/worker.ts. The documented deployment flow installs dependencies and runs pnpm run deploy; the resulting endpoint follows the investor-agent.<your-subdomain>.workers.dev pattern, unless a custom domain is attached through Cloudflare.

For local development, the repository documents pnpm install, pnpm run test, and pnpm run typecheck. No API key or environment variable is specified in the supplied setup material.

Tools and capabilities

• get_stock_info: Retrieves price, financial, earnings, ownership, analyst-rating, and company-profile information.
• historical_prices: Returns OHLCV history with configurable period and record limits.
• get_options: Lists option contracts ordered by open interest.
• market_movers: Finds leading gainers, decliners, or active stocks.
• earnings_calendar: Provides upcoming NASDAQ earnings reports.
• fear_greed_index: Retrieves stock-market or crypto Fear & Greed data from CNN.
• technical_indicator: Calculates SMA, EMA, RSI, MACD, or Bollinger Bands.

Limitations and notes

The supplied documentation identifies data and research functions only. It does not specify update frequency, rate limits, historical-data retention, market-data licensing, or guarantees about data completeness. Results should therefore be checked against the relevant source before making investment decisions. The project is released under the MIT license.