About ferdousbhai/investor-agent
ferdousbhai/investor-agent is an MCP server published by ferdousbhai in the Developer Tools category: a Model Context Protocol server for building an investor agent.
The repository has 347 stars and 63 forks, with the last commit 8 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/ferdousbhai/investor-agentThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
earnings_calendarUpcoming earnings reports from NASDAQ
Parameters not published.
fear_greed_indexCNN stock market or crypto Fear & Greed index
Parameters not published.
get_optionsOptions contracts sorted by open interest (default: top 25 per type)
Parameters not published.
get_stock_infoStock fundamentals — price, financials, earnings, ownership, analyst ratings, profile
Parameters not published.
historical_pricesOHLCV price history (default: 1 year weekly, limit 100)
Parameters not published.
market_moversTop gaining, losing, or most active stocks
Parameters not published.
technical_indicatorSMA, EMA, RSI, MACD, or Bollinger Bands
Parameters not published.
Ask AI
Ask AI about ferdousbhai/investor-agent
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 11 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
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
| 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
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
README fetched from the repository 11 hours ago. The original is authoritative.