An AI-powered MCP server for value investors. Analyze stocks using principles from Benjamin Graham and Warren Buffett. Every value investor deserves their own AI agent.
"Price is what you pay. Value is what you get." - Warren Buffett
This tool is for educational and research purposes only. It does not constitute investment advice. Investing involves risks, including the potential loss of principal. The author is not responsible for any investment decisions made based on this tool.
- 📊 Real-time Stock Data - Quotes, financials, and company profiles
- 🧮 Intrinsic Value Calculation - DCF model and Graham Number
- 🏰 Moat Analysis - Evaluate competitive advantages
- 📰 News Aggregation - Stay informed on your watchlist
- 📝 Report Generation - Daily summaries and deep analysis reports
- 🔌 Pluggable Data Sources - Easy to add your own data providers
- Node.js >= 18.0.0
- Any MCP-compatible client (Claude Desktop, Claude Code, or your own application)
Note: This is a standalone MCP server that can run on Windows, macOS, or Linux. It can be used with any application that supports the Model Context Protocol, not just Claude products.
No installation required:
npx value-investing-agentOr configure in your MCP client:
{
"mcpServers": {
"value-investing-agent": {
"command": "npx",
"args": ["-y", "value-investing-agent"]
}
}
}npm install -g value-investing-agentConfigure MCP:
{
"mcpServers": {
"value-investing-agent": {
"command": "value-investing-agent"
}
}
}git clone https://github.com/danielchu97/Value-Investing-Agent.git
cd Value-Investing-Agent
npm install
npm run buildConfigure MCP:
{
"mcpServers": {
"value-investing-agent": {
"command": "node",
"args": ["/path/to/value-investing-agent/dist/index.js"]
}
}
}Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
"Get me the current quote for Apple"
"What's the price of MSFT?"
"Calculate the intrinsic value of AAPL"
"What is Amazon's fair value using DCF?"
"Analyze the competitive moat of Coca-Cola"
"Does Microsoft have a wide moat?"
"Add GOOGL to my watchlist in the Technology group"
"Show my watchlist"
"Remove TSLA from watchlist"
"Generate a daily report for my watchlist"
"Create a detailed analysis report for Berkshire Hathaway"
| Tool | Description |
|---|---|
get_stock_quote |
Get real-time stock quote and metrics |
get_financials |
Fetch financial statements (income, balance, cash flow) |
calculate_intrinsic_value |
DCF and Graham valuation with margin of safety |
analyze_moat |
Evaluate competitive advantages |
get_news |
Get stock-related news articles |
manage_watchlist |
Manage your personal stock watchlist |
generate_daily_report |
Daily summary of watchlist stocks |
generate_stock_report |
Comprehensive value investing analysis |
set_provider |
Switch data provider |
list_providers |
List available data providers |
The plugin architecture allows you to add your own data sources. See Custom Provider Guide.
| Provider | API Key | Rate Limit | Best For |
|---|---|---|---|
| yahoo-finance (default) | Not required | Limited (may hit 429 errors) | Quick testing |
| finnhub | Required (free) | 60 calls/min | Production use |
| alpha-vantage | Required (free) | 5 calls/min | Basic data needs |
Finnhub (Recommended for reliable access):
- Get free API key at finnhub.io/register
- Set environment variable:
Or in Claude Desktop config:
export FINNHUB_API_KEY=your_api_key_here{ "mcpServers": { "value-investing-agent": { "command": "npx", "args": ["-y", "value-investing-agent"], "env": { "FINNHUB_API_KEY": "your_api_key_here" } } } }
Alpha Vantage:
- Get free API key at alphavantage.co
- Set environment variable:
ALPHA_VANTAGE_API_KEY=your_key
"Switch to finnhub provider"
"Use alpha-vantage for data"
"List available providers"
- Copy
src/providers/provider-template.ts - Implement the
DataProviderinterface - Register in
src/providers/index.ts
import { MyProvider } from './my-provider';
registerProvider('my-provider', (config) => new MyProvider(config));This tool is built on timeless investment principles:
A company's true worth based on future cash flows, not market price.
Buy only when price is significantly below intrinsic value (25%+ discount).
Seek durable competitive advantages that protect profits.
Only invest in businesses you understand.
Use market emotions as opportunities, don't be ruled by them.
- P/E Ratio: < 15 (undervalued)
- P/B Ratio: < 1.5 (undervalued)
- Graham Number: Price ceiling for defensive investors
- ROE: > 15% (excellent)
- Gross Margin: > 40% (pricing power)
- Net Margin: > 10% (efficient)
- Current Ratio: > 1.5 (liquid)
- Debt/Equity: < 1.0 (conservative)
- Interest Coverage: > 5x (safe)
# Install dependencies
npm install
# Build
npm run build
# Development mode (watch)
npm run dev
# Run tests
npm test
# Lint
npm run lintvalue-investing-agent/
├── src/
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server
│ ├── providers/ # Data providers
│ ├── tools/ # MCP tools
│ ├── analysis/ # Analysis engine
│ ├── utils/ # Utilities
│ ├── config/ # Configuration
│ └── types/ # TypeScript types
├── skills/ # Claude skills
├── data/ # Local data (watchlist, cache)
├── docs/ # Documentation
└── tests/ # Test files
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
- Fork the repository
- Create a feature branch
- Make your changes
- Run tests
- Submit a pull request
MIT License - see LICENSE for details.
This project is inspired by the investment wisdom of:
- Benjamin Graham - The Intelligent Investor, Security Analysis
- Warren Buffett - Berkshire Hathaway Letters to Shareholders
- Charlie Munger - Poor Charlie's Almanack
- The Intelligent Investor by Benjamin Graham
- Berkshire Hathaway Letters
- Value Investing Guide
Remember: "The stock market is designed to transfer money from the active to the patient." - Warren Buffett