VibeTrader MCP: Control Your Trading Bots with AI Assistants

What is VibeTrader MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect with external tools and data sources. VibeTrader's MCP server lets you manage your trading bots directly through AI assistants like Claude, Cursor, Windsurf, and other MCP-compatible tools.

Instead of switching between apps, you can simply ask your AI assistant: "Show me my trading bots" or "What's my portfolio balance?" and get real-time data from your VibeTrader account.

---

Why Use MCP for Trading?

1. Natural Language Control

No need to remember button locations or navigate menus. Just describe what you want in plain English.

2. Unified Workflow

Manage your trading bots alongside your coding, research, and analysis—all within your AI assistant.

3. Powerful Analysis

Ask your AI to analyze your trade history, identify patterns, and suggest improvements to your strategies.

4. Hands-Free Trading

Create, start, pause, and modify bots without leaving your current workflow.

---

Available Tools

The VibeTrader MCP server provides these capabilities:

Bot Management

• list_bots — View all your trading bots with P&L
• get_bot — Get detailed info about a specific bot
• create_bot — Create a new bot using natural language
• start_bot / pause_bot — Control bot execution
• start_all_bots / pause_all_bots — Batch control all bots
• update_bot — Update bot name or status
• delete_bot — Remove a bot

Strategy Tools

• get_bot_strategy — View full strategy config (entry/exit rules, indicators)
• explain_bot_strategy — Get plain English explanation of how a bot works
• refine_bot — Modify a strategy using natural language

Portfolio & Account

• get_portfolio — View positions and account balance
• get_positions — Get current open positions with unrealized P&L
• get_account_summary — See buying power, cash, and key metrics
• get_quote — Get current price for any stock or ETF
• get_market_status — Check if US markets are open

Trading

• place_order — Place buy/sell orders (market or limit)
• close_position — Close a position (all, specific qty, or percentage)

Backtesting

• run_backtest — Run historical simulation on a bot's strategy
• list_backtests — View all previous backtests for a bot
• get_backtest — Get detailed results including trades and equity curve
• quick_covered_call_backtest — Quick income projection for covered call strategies

Trade History & Analytics

• get_trade_history — Recent trades across all bots
• get_bot_trades — Trade history for a specific bot with win rate
• get_daily_trade_stats — Daily P&L breakdown with best/worst days
• get_bot_stats — Aggregate statistics across your bots

AI Analysis Reports

• run_risk_report — AI-powered risk analysis (position concentration, sector exposure, loss alerts)
• run_performance_report — Performance diagnostics (returns vs benchmarks, winners/losers, trade stats)
• run_rebalance_report — Allocation analysis (sector drift, cash position, concentration metrics)

---

Getting Started

Step 1: Get Your API Key

• Log in to vibetrader.markets
• Go to Settings → API Keys
• Click Generate API Key
• Copy your key (starts with vt_)

Step 2: Configure Your AI Assistant

Add the VibeTrader MCP server to your assistant's configuration.

For Windsurf/Cursor (mcp_config.json):

{

"mcpServers": {

"vibetrader": {

"command": "npx",

"args": [

"-y",

"mcp-remote",

"https://vibetrader-mcp-289016366682.us-central1.run.app/mcp"

]

}

}

}

Step 3: Authenticate

Once connected, tell your AI assistant:

> "Authenticate with VibeTrader using API key vt_your_key_here"

You'll see a confirmation message, and then all tools become available.

---

Example Conversations

Check Your Bots

> You: "Show me my trading bots"

>

> AI: Lists all your bots with status, mode (paper/live), and total P&L

Analyze Performance

> You: "What's the trade history for my SPY bot? Show me the win rate."

>

> AI: Returns trades with summary stats—total P&L, winning/losing trades, win rate percentage

Understand a Strategy

> You: "Explain how my RSI bot decides when to buy and sell"

>

> AI: Provides plain English explanation of entry rules, exit rules, and risk settings

Refine a Strategy

> You: "Add a 5% trailing stop to my TSLA bot"

>

> AI: Updates the bot's strategy with the new trailing stop, pauses the bot during refinement, and confirms the change

Quick Market Check

> You: "What's the current price of NVDA and is the market open?"

>

> AI: Returns current quote and market status

Get AI Portfolio Analysis

> You: "Run a risk analysis on my live portfolio"

>

> AI: Returns detailed risk diagnostics including position concentration, sector exposure, and threshold compliance with actionable insights

---

Security Best Practices

• Never share your API key publicly - Treat it like a password
• Use paper trading first - Test commands before live trading
• Revoke unused keys - Remove API keys you no longer need
• Monitor your bots - Check the VibeTrader dashboard regularly

---

Supported AI Assistants

VibeTrader MCP works with any MCP-compatible client:

• Claude (via Claude Desktop or API)
• Windsurf (Codeium's AI IDE)
• Cursor (AI code editor)
• Custom integrations (any MCP-compatible tool)

---

What's Next?

We're continuously adding new tools to the MCP server:

• Alerts - Set price alerts and get notified
• Watchlist management - Track your favorite stocks
• Multi-account support - Manage multiple trading accounts
• Options strategies - Manage covered calls and more

---

Start Trading with AI

The VibeTrader MCP server brings the power of AI assistants to your trading workflow. Analyze your bots, refine strategies, and monitor your portfolio—all through natural conversation.

Get your API key and connect your favorite AI assistant today.