investor-agent
A Model Context Protocol server for building an investor agent
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/ferdousbhai--investor-agent)HTML
<a href="/listings/ferdousbhai--investor-agent"><img src="/api/listings/ferdousbhai--investor-agent/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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"]
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/plugin.json · Manifest · 20 lines
- {
- "name": "investor",
- "version": "3.0.0",
- "description": "Financial research MCP server — Yahoo Finance quotes, historical prices, options, market movers, earnings, fear & greed, and technical indicators",
- "author": {
- "name": "Ferdous",
- "email": "ferdous@hey.com"
- },
- "repository": "https://github.com/ferdousbhai/investor-agent",
- "license": "MIT",
- "keywords": ["finance", "stocks", "investing", "market-analysis", "trading"],
- "commands": "./commands/",
- "skills": "./skills/",
- "mcpServers": {
- "investor-agent": {
- "type": "http",
- "url": "https://investor.ferdousbhai.com/mcp"
- }
- }
- }
README.md · README · 95 lines
- # investor-agent
- Financial research MCP server for long-term investors.
- ## Trading options?
- [spicytrade](https://spicy.trade) is the options side of this server: quotes, IV rank and percentile, term structure, a catalyst calendar and a daily options brief for a tracked watchlist of US equities and ETFs, as a hosted MCP server.
- ```bash
- claude mcp add --transport http spicytrade https://spicy.trade/mcp
- ```
- Any MCP client that speaks Streamable HTTP can use the same address. The public tier needs no account and no install. Nothing it returns, the brief included, is investment advice.
- ## Setup
- ### Hosted (remote MCP)
- A hosted instance runs on Cloudflare Workers at `https://investor.ferdousbhai.com/mcp` (Streamable HTTP, no auth). For Claude Code:
- ```bash
- claude mcp add --transport http investor-agent https://investor.ferdousbhai.com/mcp
- ```
- Or in an MCP client config that supports remote servers:
- ```json
- {
- "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:
- ```bash
- 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:
- ```json
- {
- "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
- ```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`). `cloudflare.config.ts` is ready to deploy as-is with the `cf` CLI:
- ```bash
- 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.