English Français العربية

Investor Agent

Community Finance and payments

Fetch stock market data, including options recommendations, from Yahoo Finance.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. investor-agent
  2. Setup
  3. Tools
  4. Development
  5. Deploy to Cloudflare Workers
  6. License

investor-agent

Financial research MCP server for long-term investors.

Setup

Hosted (remote MCP)

A hosted instance runs on Cloudflare Workers at https://investor.ferdousbhai.com/mcp (Streamable HTTP, no auth). For Claude Code:

claude mcp add --transport http investor-agent https://investor.ferdousbhai.com/mcp

Or in an MCP client config that supports remote servers:

{
  "mcpServers": {
    "investor-agent": {
      "type": "http",
      "url": "https://investor.ferdousbhai.com/mcp"
    }
  }
}
Local (stdio, from source)

This package is not published to npm. Do not run npx investor-agent: nothing under that npm name is published by this project. Build from this repository instead:

git clone https://github.com/ferdousbhai/investor-agent.git
cd investor-agent
pnpm install
pnpm run build

Then point your client at the built entry point:

{
  "mcpServers": {
    "investor-agent": {
      "command": "node",
      "args": ["/absolute/path/to/investor-agent/dist/index.js"]
    }
  }
}

Tools

ToolDescription
get_stock_infoStock fundamentals — price, financials, earnings, ownership, analyst ratings, profile
historical_pricesOHLCV price history (default: 1 year weekly, limit 100)
get_optionsOptions contracts sorted by open interest (default: top 25 per type)
market_moversTop gaining, losing, or most active stocks
earnings_calendarUpcoming earnings reports from NASDAQ
fear_greed_indexCNN stock market or crypto Fear & Greed index
technical_indicatorSMA, EMA, RSI, MACD, or Bollinger Bands

Development

pnpm install
pnpm run test
pnpm run typecheck

Deploy to Cloudflare Workers

The server also runs as a remote MCP server on Workers (src/worker.ts). cloudflare.config.ts is ready to deploy as-is with the cf CLI:

pnpm install
pnpm run deploy

Point your client at https://investor-agent.<your-subdomain>.workers.dev/mcp, or attach a custom domain in the Cloudflare dashboard.

License

MIT

Frequently asked questions

What is Investor Agent?

Fetch stock market data, including options recommendations, from Yahoo Finance.

How do I install Investor Agent?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Investor Agent open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Investor Agent?

It is published by ferdousbhai. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.