# investor-lens-mcp

PlayMCP-ready MCP for educational US market analysis.

It combines:

- USD/KRW exchange-rate context from Frankfurter.
- US stock and ETF snapshots from the unofficial `yahoo-finance2` package.
- Static fallback profiles when Yahoo Finance is unavailable.
- Five investor lenses: Warren Buffett, Benjamin Graham, Peter Lynch, Ray Dalio, and Cathie Wood.

The MCP does not provide personalized financial advice. It returns educational watchlist ideas, reasoning, risks, and follow-up checks.

## Tools

- `get_exchange_context`: USD/KRW or other FX pair context for Korean investors.
- `get_us_stock_snapshot`: one ticker with Yahoo Finance metrics and investor-lens interpretation.
- `screen_us_stock_ideas`: rank candidate US stocks/ETFs by theme and persona.
- `analyze_with_investor_lens`: compare tickers across multiple investor lenses.
- `recommend_watchlist_by_persona`: generate a current educational watchlist for one persona.

## Local Development

```bash
npm install
npm run typecheck
npm test
npm run build
```

Run as a local stdio MCP:

```bash
npm start
```

Run the Vercel HTTP endpoint locally:

```bash
vercel dev
node scripts/check-live.mjs http://localhost:3000
```

## PlayMCP Registration Draft

| Field | Value |
|---|---|
| MCP 이름 | 투자자 렌즈 미국시장 가이드 |
| MCP 식별자 | investorLens |
| 인증 방식 | 인증 사용하지 않음 |
| MCP Endpoint | `https://investor-lens-mcp.vercel.app/api/mcp` |
| 대표 이미지 | `docs/assets/investor-lens-playmcp.png` |

Description:

```text
환율, 미국 주식 데이터, ETF 기준선, 유명 투자자 5명의 관점을 합쳐 미국시장 검토 후보를 교육용으로 정리합니다. 워런 버핏, 벤저민 그레이엄, 피터 린치, 레이 달리오, 캐시 우드 렌즈로 같은 종목을 다르게 해석하고, 근거와 리스크, 확인 질문을 함께 제공합니다. 개인 맞춤 매수/매도 조언이 아니라 투자 공부와 후보 검토를 돕는 MCP입니다.
```

Conversation examples:

1. `워런 버핏 관점에서 지금 볼 만한 미국 주식 후보 알려줘`
2. `USD/KRW 환율이 미국 주식 투자에 어떤 영향을 주는지 설명해줘`
3. `NVDA, MSFT, BRK-B를 투자자 5명 관점으로 비교해줘`

Verified locally:

- `npm run typecheck`
- `npm test`
- `npm run build`
- `node scripts/check-live.mjs http://localhost:3000`

## Safety Boundary

Every tool response includes the same boundary:

```text
교육용 시장 분석입니다. 개인의 재무상황, 투자목적, 위험성향을 반영한 매수/매도/보유 권유가 아니며, 실제 투자 전에는 스스로 추가 확인하거나 전문가와 상담해야 합니다.
```