Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ferdousbhai--investor-agent/badge.svg)](/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

i

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
  1. {
  2. "name": "investor",
  3. "version": "3.0.0",
  4. "description": "Financial research MCP server — Yahoo Finance quotes, historical prices, options, market movers, earnings, fear & greed, and technical indicators",
  5. "author": {
  6. "name": "Ferdous",
  7. "email": "ferdous@hey.com"
  8. },
  9. "repository": "https://github.com/ferdousbhai/investor-agent",
  10. "license": "MIT",
  11. "keywords": ["finance", "stocks", "investing", "market-analysis", "trading"],
  12. "commands": "./commands/",
  13. "skills": "./skills/",
  14. "mcpServers": {
  15. "investor-agent": {
  16. "type": "http",
  17. "url": "https://investor.ferdousbhai.com/mcp"
  18. }
  19. }
  20. }
README.md · README · 95 lines
  1. # investor-agent
  2. Financial research MCP server for long-term investors.
  3. ## Trading options?
  4. [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.
  5. ```bash
  6. claude mcp add --transport http spicytrade https://spicy.trade/mcp
  7. ```
  8. 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.
  9. ## Setup
  10. ### Hosted (remote MCP)
  11. A hosted instance runs on Cloudflare Workers at `https://investor.ferdousbhai.com/mcp` (Streamable HTTP, no auth). For Claude Code:
  12. ```bash
  13. claude mcp add --transport http investor-agent https://investor.ferdousbhai.com/mcp
  14. ```
  15. Or in an MCP client config that supports remote servers:
  16. ```json
  17. {
  18. "mcpServers": {
  19. "investor-agent": {
  20. "type": "http",
  21. "url": "https://investor.ferdousbhai.com/mcp"
  22. }
  23. }
  24. }
  25. ```
  26. ### Local (stdio, from source)
  27. 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:
  28. ```bash
  29. git clone https://github.com/ferdousbhai/investor-agent.git
  30. cd investor-agent
  31. pnpm install
  32. pnpm run build
  33. ```
  34. Then point your client at the built entry point:
  35. ```json
  36. {
  37. "mcpServers": {
  38. "investor-agent": {
  39. "command": "node",
  40. "args": ["/absolute/path/to/investor-agent/dist/index.js"]
  41. }
  42. }
  43. }
  44. ```
  45. ## Tools
  46. | Tool | Description |
  47. |------|-------------|
  48. | `get_stock_info` | Stock fundamentals — price, financials, earnings, ownership, analyst ratings, profile |
  49. | `historical_prices` | OHLCV price history (default: 1 year weekly, limit 100) |
  50. | `get_options` | Options contracts sorted by open interest (default: top 25 per type) |
  51. | `market_movers` | Top gaining, losing, or most active stocks |
  52. | `earnings_calendar` | Upcoming earnings reports from NASDAQ |
  53. | `fear_greed_index` | CNN stock market or crypto Fear & Greed index |
  54. | `technical_indicator` | SMA, EMA, RSI, MACD, or Bollinger Bands |
  55. ## Development
  56. ```bash
  57. pnpm install
  58. pnpm run test
  59. pnpm run typecheck
  60. ```
  61. ## Deploy to Cloudflare Workers
  62. 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:
  63. ```bash
  64. pnpm install
  65. pnpm run deploy
  66. ```
  67. Point your client at `https://investor-agent.<your-subdomain>.workers.dev/mcp`, or attach a custom domain in the Cloudflare dashboard.
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.