investor-agent

View on GitHub

A Model Context Protocol server for building an investor agent Python-based implementation.

285 stars PythonAI & Machine Learning Updated Nov 1, 2025

Documentation

investor-agent

Financial research MCP server for long-term investors.

Setup

json

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

Tools

Tool	Description
`get_stock_info`	Stock fundamentals — price, financials, earnings, ownership, analyst ratings, profile
`historical_prices`	OHLCV price history (default: 1 year weekly, limit 100)
`get_options`	Options contracts sorted by open interest (default: top 25 per type)
`market_movers`	Top gaining, losing, or most active stocks
`earnings_calendar`	Upcoming earnings reports from NASDAQ
`fear_greed_index`	CNN stock market or crypto Fear & Greed index
`technical_indicator`	SMA, EMA, RSI, MACD, or Bollinger Bands

Development

bash

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`). `wrangler.jsonc` is ready to deploy as-is:

bash

pnpm install
pnpm run deploy

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

License

MIT

Frequently asked questions

What is investor-agent?

investor-agent is A Model Context Protocol server for building an investor agent Python-based implementation.

How do I install investor-agent?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is investor-agent open source?

Yes, it is hosted on GitHub at https://github.com/ferdousbhai/investor-agent and has 285 stars.

Related MCP tools

openhands

🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

64,677 Python

agentartificial-intelligencechatgpt+6

mem0

Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.

42,646 Python

agentsaiai-agents+12

chatgpt-on-wechat

基于大模型搭建的聊天机器人，同时支持微信公众号、企业微信应用、飞书、钉钉等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。

39,573 Python

aiai-agentchatgpt+17

gpt-researcher

An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to

24,026 Python

agentaiautomation+8

fastmcp

🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

19,927 Python

agentsfastmcpllms+6

maxkb

🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po

19,062 Python

agentagentic-aichatbot+11

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP