VibeTrader MCP Server

1# VibeTrader MCP Server
2 
3<p align="center">
4  <img src="https://vibetrader.markets/icons/VibeTrader%20-%20Logo%20-%20Icon.svg" width="80" alt="VibeTrader Logo">
5</p>
6 
7<p align="center">
8  <strong>Trade stocks directly from your AI assistant</strong><br>
9  Create bots, manage portfolios, and execute trades with natural language
10</p>
11 
12<p align="center">
13  <a href="https://vibetrader.markets">Website</a> •
14  <a href="https://vibetrader.markets/blog/mcp-server">Documentation</a> •
15  <a href="https://vibetrader.markets/settings">Get API Key</a>
16</p>
17 
18---
19 
20A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that connects AI assistants like **Claude Desktop**, **Cursor**, and **Windsurf** to VibeTrader's trading platform.
21 
22## Features
23 
24- **Create Bots**: Create AI-powered trading bots using natural language
25- **Manage Bots**: Start, pause, delete, and monitor your bots
26- **Portfolio**: View positions and account balance
27- **Market Data**: Get quotes and options chains
28- **Backtesting**: Test strategies on historical data
29 
30## Available Tools
31 
32| Tool | Description |
33|------|-------------|
34| `authenticate` | Connect with your VibeTrader API token |
35| `create_bot` | Create a trading bot from natural language |
36| `list_bots` | List all your bots |
37| `get_bot` | Get detailed bot info |
38| `start_bot` | Start a paused bot |
39| `pause_bot` | Pause a running bot |
40| `delete_bot` | Delete a bot |
41| `set_trading_mode` | Switch between paper/live trading |
42| `get_portfolio` | View your positions |
43| `get_trade_history` | See recent trades |
44| `get_quote` | Get stock/ETF quotes |
45| `get_options_chain` | Get options data |
46| `backtest_strategy` | Backtest a strategy |
47| `list_strategy_templates` | See available templates |
48 
49## Setup for Claude Desktop
50 
511. Get your API token from https://vibetrader.markets/settings
52 
532. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
54 
55```json
56{
57  "mcpServers": {
58    "vibetrader": {
59      "url": "https://vibetrader-mcp-289016366682.us-central1.run.app/sse"
60    }
61  }
62}
63```
64 
653. Restart Claude Desktop
66 
674. In a conversation, first authenticate:
68   > "Use the vibetrader authenticate tool with my token: [YOUR_TOKEN]"
69 
705. Then create bots:
71   > "Create a trading bot that buys AAPL when RSI goes below 30"
72 
73## Example Conversations
74 
75**Create a momentum bot:**
76> "Create a trading bot that buys AAPL when RSI crosses below 30 and sells when it crosses above 70"
77 
78**Check your bots:**
79> "Show me all my trading bots and their performance"
80 
81**Backtest a strategy:**
82> "Backtest a moving average crossover strategy on SPY for the last 6 months"
83 
84**Options trading:**
85> "Create an iron condor bot for SPY that enters when IV rank is above 50"
86 
87## Development
88 
89```bash
90# Install dependencies
91pip install -r requirements.txt
92 
93# Run locally (HTTP mode)
94python server.py
95 
96# Run in STDIO mode (for Claude Desktop)
97python server.py stdio
98```
99 
100## Deployment
101 
102Deployed on Google Cloud Run at `mcp.vibetrader.markets`
103 
104```bash
105gcloud run deploy vibetrader-mcp --source . --region us-central1
106```
107 
108## Security
109 
110- Your API token is required for authentication
111- All requests are made over HTTPS
112- Tokens are not stored on the server (stateless)
113- Paper trading mode is default for safety
114