VibeTrader MCP Server

A Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop, Cursor, and Windsurf to VibeTrader's trading platform.

Features

Create Bots: Create AI-powered trading bots using natural language
Manage Bots: Start, pause, delete, and monitor your bots
Portfolio: View positions and account balance
Market Data: Get quotes and options chains
Backtesting: Test strategies on historical data

Available Tools

Tool	Description
`authenticate`	Connect with your VibeTrader API token
`create_bot`	Create a trading bot from natural language
`list_bots`	List all your bots
`get_bot`	Get detailed bot info
`start_bot`	Start a paused bot
`pause_bot`	Pause a running bot
`delete_bot`	Delete a bot
`set_trading_mode`	Switch between paper/live trading
`get_portfolio`	View your positions
`get_trade_history`	See recent trades
`get_quote`	Get stock/ETF quotes
`get_options_chain`	Get options data
`backtest_strategy`	Backtest a strategy
`list_strategy_templates`	See available templates

Setup for Claude Desktop

Get your API token from https://vibetrader.markets/settings
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vibetrader": {
      "url": "https://vibetrader-mcp-289016366682.us-central1.run.app/sse"
    }
  }
}

Restart Claude Desktop
In a conversation, first authenticate:

"Use the vibetrader authenticate tool with my token: [YOUR_TOKEN]"
Then create bots:

"Create a trading bot that buys AAPL when RSI goes below 30"

Example Conversations

Create a momentum bot:

"Create a trading bot that buys AAPL when RSI crosses below 30 and sells when it crosses above 70"

Check your bots:

"Show me all my trading bots and their performance"

Backtest a strategy:

"Backtest a moving average crossover strategy on SPY for the last 6 months"

Options trading:

"Create an iron condor bot for SPY that enters when IV rank is above 50"

Development

# Install dependencies
pip install -r requirements.txt
 
# Run locally (HTTP mode)
python server.py
 
# Run in STDIO mode (for Claude Desktop)
python server.py stdio

Deployment

Deployed on Google Cloud Run at mcp.vibetrader.markets

gcloud run deploy vibetrader-mcp --source . --region us-central1

Security

Your API token is required for authentication
All requests are made over HTTPS
Tokens are not stored on the server (stateless)
Paper trading mode is default for safety

etbars/vibetrader-mcp