vibetrader-mcp

VibeTrader MCP Server

<p align="center"> <img src="https://vibetrader.markets/icons/VibeTrader%20-%20Logo%20-%20Icon.svg" width="80" alt="VibeTrader Logo"> </p>

<p align="center"> <strong>Trade stocks directly from your AI assistant</strong><br> Create bots, manage portfolios, and execute trades with natural language </p>

<p align="center"> <a href="https://vibetrader.markets">Website</a> • <a href="https://vibetrader.markets/blog/mcp-server">Documentation</a> • <a href="https://vibetrader.markets/settings">Get API Key</a> </p>

---

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

1. Get your API token from https://vibetrader.markets/settings

1. 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"
    }
  }
}

1. Restart Claude Desktop

1. In a conversation, first authenticate:

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

1. 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