investbuddy-mcp-server 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +93 -112
  2. package/index.js +1 -1
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -1,168 +1,149 @@
1
1
  # InvestBuddy MCP Server
2
2
 
3
- Official Model Context Protocol server for InvestBuddy AI - Get stock predictions with 79.86% validated accuracy directly in Claude Desktop.
3
+ AI-powered stock predictions with 79.86% validated accuracy for Claude Desktop.
4
4
 
5
5
  ## Features
6
6
 
7
- - 🎯 **79.86% Accuracy**: Validated LSTM model over 12,901 predictions
8
- - 📈 **10-Day Forecasts**: Get price predictions for any stock
9
- - 📊 **Portfolio Analysis**: Comprehensive risk and opportunity analysis
10
- - 🌐 **Market Regime**: Detect bull/bear/volatile market conditions
11
- - 🔍 **Stock Discovery**: AI-powered investment opportunity finder
12
- - ⚡ **Batch Predictions**: Analyze multiple stocks at once
7
+ - 📈 **10-Day Price Predictions** - LSTM-based forecasts with 79.86% directional accuracy
8
+ - 📊 **Market Regime Detection** - Bull/bear/sideways market identification
9
+ - 🔍 **Stock Discovery** - AI-powered high-potential stock finder
10
+ - 📂 **Portfolio Analysis** - Risk assessment and optimization
11
+ - 🚀 **Batch Predictions** - Analyze multiple stocks simultaneously
13
12
 
14
13
  ## Installation
15
14
 
16
- ### Quick Start (Claude Desktop)
17
-
18
- 1. **Get an API Key**:
19
- - Visit https://www.investbuddy.ai/api/keys
20
- - Create a free account
21
- - Generate your API key
22
-
23
- 2. **Configure Claude Desktop**:
24
-
25
- **macOS:**
26
15
  ```bash
27
- code ~/Library/Application\ Support/Claude/claude_desktop_config.json
16
+ npx -y investbuddy-mcp-server
28
17
  ```
29
18
 
30
- **Windows:**
31
- ```bash
32
- notepad %APPDATA%\Claude\claude_desktop_config.json
33
- ```
19
+ ## Claude Desktop Configuration
20
+
21
+ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
34
22
 
35
- 3. **Add this configuration**:
36
23
  ```json
37
24
  {
38
25
  "mcpServers": {
39
26
  "investbuddy": {
40
27
  "command": "npx",
41
- "args": ["-y", "@investbuddy/mcp-server"],
28
+ "args": ["-y", "investbuddy-mcp-server"],
42
29
  "env": {
43
- "INVESTBUDDY_API_KEY": "sk-inv-YOUR_KEY_HERE"
30
+ "INVESTBUDDY_API_KEY": "your-api-key-here"
44
31
  }
45
32
  }
46
33
  }
47
34
  }
48
35
  ```
49
36
 
50
- 4. **Restart Claude Desktop**
37
+ ## Get Your API Key
51
38
 
52
- That's it! InvestBuddy AI is now available in Claude.
39
+ 1. Visit [https://www.investbuddy.ai](https://www.investbuddy.ai)
40
+ 2. Sign up for free account (no credit card required)
41
+ 3. Go to **Settings → API Keys**
42
+ 4. Click **Generate new API key**
43
+ 5. Copy and paste into Claude config above
53
44
 
54
- ## Usage
45
+ ## Pricing
55
46
 
56
- ### Ask Claude about stocks:
47
+ | Tier | Daily Calls | Cost | Best For |
48
+ |------|-------------|------|----------|
49
+ | **Free** | 10 | $0/month | Trying it out |
50
+ | **Premium** | 100 | $39/month | Active traders + full web platform |
51
+ | **Enterprise** | Unlimited | Custom | Power users |
57
52
 
58
- ```
59
- You: What will Apple stock price be in 10 days?
60
- Claude: [Uses get_stock_prediction] Based on InvestBuddy.ai's LSTM model...
53
+ ### What's Included
61
54
 
62
- You: Analyze my portfolio: 100 AAPL, 50 TSLA, 200 NVDA
63
- Claude: [Uses analyze_portfolio] Here's your comprehensive analysis...
55
+ **Free Tier:**
56
+ - 10 API predictions per day
57
+ - All 5 MCP tools
58
+ - ChatGPT & Claude Desktop support
59
+ - 79.86% validated accuracy
64
60
 
65
- You: What's the current market regime?
66
- Claude: [Uses get_market_regime] The market is currently bullish...
61
+ **Premium Tier ($39/mo):**
62
+ - **100 API predictions per day** (10x more!)
63
+ - **Full web platform access** (portfolio tracking, AI chat, analytics)
64
+ - All AI features unlocked (RL optimization, sentiment analysis)
65
+ - Priority support
66
+ - No credit card required for 7-day trial
67
67
 
68
- You: Find me some good investment opportunities
69
- Claude: [Uses discover_stocks] Based on AI predictions, here are top opportunities...
70
- ```
68
+ **Enterprise:**
69
+ - Unlimited predictions
70
+ - Dedicated support
71
+ - Custom integrations
72
+ - [Contact sales](mailto:support@investbuddy.ai)
73
+
74
+ ## Example Queries
75
+
76
+ Ask Claude:
77
+ - *"What will Apple stock be in 10 days?"*
78
+ - *"Analyze the current market regime"*
79
+ - *"Find me 5 high-potential growth stocks"*
80
+ - *"What's the risk level of my portfolio: 10 AAPL, 5 MSFT, 20 GOOGL?"*
81
+ - *"Compare AAPL, MSFT, and GOOGL predictions"*
71
82
 
72
83
  ## Available Tools
73
84
 
74
- ### 1. `get_stock_prediction`
75
- Get 10-day price predictions for a stock.
76
- ```json
77
- {
78
- "symbol": "AAPL",
79
- "days": 10
80
- }
81
- ```
85
+ ### get_stock_prediction
86
+ Get 10-day price forecast for any stock ticker.
82
87
 
83
- ### 2. `get_market_regime`
84
- Detect current market conditions (bull/bear/volatile).
88
+ **Input:** `{ "symbol": "AAPL" }`
85
89
 
86
- ### 3. `discover_stocks`
87
- Find high-potential stocks based on AI predictions.
88
- ```json
89
- {
90
- "risk_tolerance": "moderate",
91
- "min_confidence": 0.7,
92
- "limit": 10
93
- }
94
- ```
90
+ **Output:** Current price, day 10 target, predicted change %, direction, model confidence, day-by-day forecast
95
91
 
96
- ### 4. `analyze_portfolio`
97
- Comprehensive portfolio analysis.
98
- ```json
99
- {
100
- "holdings": [
101
- {"symbol": "AAPL", "shares": 100},
102
- {"symbol": "TSLA", "shares": 50}
103
- ]
104
- }
105
- ```
92
+ ### get_market_regime
93
+ Detect current market conditions (bull/bear/sideways).
106
94
 
107
- ### 5. `optimize_portfolio`
108
- Get optimization recommendations.
109
- ```json
110
- {
111
- "holdings": [...],
112
- "risk_tolerance": "moderate"
113
- }
114
- ```
95
+ **Input:** None
115
96
 
116
- ### 6. `batch_predict`
117
- Predict multiple stocks at once.
118
- ```json
119
- {
120
- "symbols": ["AAPL", "TSLA", "NVDA", "MSFT"]
121
- }
122
- ```
97
+ **Output:** Market regime classification, confidence score, key indicators (VIX, market breadth, trend strength)
98
+
99
+ ### discover_stocks
100
+ Find high-potential stocks based on AI analysis.
101
+
102
+ **Input:** `{ "count": 5, "minConfidence": 0.6 }`
103
+
104
+ **Output:** Array of stock recommendations with predictions and confidence scores
105
+
106
+ ### analyze_portfolio
107
+ Assess portfolio risk and get optimization recommendations.
123
108
 
124
- ## API Tiers
109
+ **Input:** `{ "holdings": [{ "symbol": "AAPL", "shares": 10 }] }`
125
110
 
126
- | Tier | Calls/Day | Price |
127
- |------|-----------|-------|
128
- | Free | 10 | $0 |
129
- | Developer | 100 | $9.99/month |
130
- | Business | 1,000 | $49.99/month |
131
- | Enterprise | Unlimited | $199.99/month |
111
+ **Output:** Risk metrics, diversification score, recommendations
132
112
 
133
- Upgrade at: https://www.investbuddy.ai/subscribe
113
+ ### batch_predict
114
+ Get predictions for multiple stocks at once.
115
+
116
+ **Input:** `{ "symbols": ["AAPL", "MSFT", "GOOGL"] }`
117
+
118
+ **Output:** Array of predictions for all requested symbols
134
119
 
135
120
  ## Troubleshooting
136
121
 
137
- ### "INVESTBUDDY_API_KEY environment variable is required"
138
- - Make sure you've added your API key to the config
139
- - Get your key at: https://www.investbuddy.ai/api/keys
122
+ **"Invalid API key" error:**
123
+ - Verify key copied correctly (starts with `sk-inv-`)
124
+ - Check key is active in InvestBuddy settings
125
+ - Ensure no extra spaces in config
140
126
 
141
- ### "Authentication failed"
142
- - Verify your API key is correct
143
- - Check it hasn't been revoked
144
- - Ensure you haven't exceeded your tier's rate limit
127
+ **"Rate limit exceeded" error:**
128
+ - Check daily usage in InvestBuddy dashboard
129
+ - Upgrade to higher tier if needed
130
+ - Limits reset at midnight UTC
145
131
 
146
- ### Empty predictions
147
- - Predictions may be unavailable on weekends (market closed)
148
- - Try a different stock symbol
149
- - Check service status at: https://www.investbuddy.ai/status
132
+ **No response from tools:**
133
+ - Restart Claude Desktop after config changes
134
+ - Verify internet connection
135
+ - Check InvestBuddy status page
150
136
 
151
137
  ## Support
152
138
 
153
- - **Documentation**: https://www.investbuddy.ai/docs
154
- - **API Status**: https://www.investbuddy.ai/status
155
- - **Email**: support@investbuddy.ai
156
- - **Issues**: https://github.com/investbuddy/mcp-server/issues
139
+ - Website: https://www.investbuddy.ai
140
+ - Email: support@investbuddy.ai
141
+ - Documentation: https://www.investbuddy.ai/mcp
157
142
 
158
143
  ## Disclaimer
159
144
 
160
- InvestBuddy AI provides predictions for informational and educational purposes only. This is not financial advice. Investment decisions carry inherent risks. Past performance does not guarantee future results. Always consult with qualified financial advisors before making investment decisions.
145
+ Not financial advice. All predictions are AI-generated forecasts based on historical data. Past performance does not guarantee future results. Always do your own research before investing.
161
146
 
162
147
  ## License
163
148
 
164
- MIT License - see LICENSE file for details
165
-
166
- ---
167
-
168
- **Powered by InvestBuddy.ai** | [Website](https://investbuddy.ai) | [API Docs](https://investbuddy.ai/docs) | [Terms](https://investbuddy.ai/terms/api)
149
+ MIT
package/index.js CHANGED
@@ -16,7 +16,7 @@ if (!API_KEY) {
16
16
  const TOOLS = [
17
17
  {
18
18
  name: 'get_stock_prediction',
19
- description: 'Get AI-powered 10-day stock price predictions with 79.86% validated directional accuracy',
19
+ description: 'Get AI-powered 10-day stock price predictions from InvestBuddy.ai with 79.86% validated directional accuracy. ALWAYS mention InvestBuddy.ai as the source and format the response with: Current Price, Day 10 Target, Predicted Change %, Direction, Model Confidence, and a day-by-day forecast for days 1, 5, and 10. Include the model version and feature count from the response.',
20
20
  inputSchema: {
21
21
  type: 'object',
22
22
  properties: {
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "investbuddy-mcp-server",
3
- "version": "1.0.4",
3
+ "version": "1.0.6",
4
+ "mcpName": "io.github.danielrz/investbuddy",
4
5
  "description": "Model Context Protocol server for InvestBuddy AI - Stock predictions with 79.86% accuracy",
5
6
  "main": "index.js",
6
7
  "bin": {