Vibetrader MCP

What etbars/vibetrader-mcp MCP server does

The etbars/vibetrader-mcp MCP server exposes VibeTrader trading-platform operations to MCP clients. It supports creating bots from natural-language strategy descriptions, reviewing existing bots, changing whether they are paused or running, and removing them. It also provides portfolio and trade-history information, stock and ETF quotes, options-chain data, strategy backtesting, and access to available strategy templates.

The platform is intended for use with VibeTrader and its Alpaca brokerage connection. Bot creation can be driven by instructions such as defining an RSI-based entry and exit strategy or describing an options strategy.

How it works

Connect an MCP client to the hosted SSE endpoint:

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

After the client is connected, call authenticate with a VibeTrader API token. The token is obtained from the VibeTrader settings page. Subsequent tool calls can operate on the authenticated account, including listing bots, reading portfolio data, requesting market data, and running backtests.

The server is stateless according to the project documentation and sends requests over HTTPS. Paper trading is the default trading mode. The set_trading_mode tool can switch between paper and live trading, so clients should confirm the selected mode before starting a bot.

Setup and configuration

The etbars/vibetrader-mcp MCP server can be configured as a remote MCP server in Claude Desktop by adding the SSE URL under an mcpServers entry and restarting the application. The README also identifies Cursor and Windsurf as supported AI assistants.

Authentication is performed inside the conversation with the authenticate tool; the API token is not shown as a server environment variable in the provided setup instructions. A typical first request tells the assistant to authenticate with the user’s VibeTrader token. Do not replace the endpoint with a local development command unless you are intentionally running the project yourself.

For local development, the repository documents installing dependencies from requirements.txt, running python server.py in HTTP mode, or passing stdio to run in STDIO mode. The provided material does not specify a package release command or a separately published installable package.

Tools and capabilities

The etbars/vibetrader-mcp MCP server exposes these operations:

• Authenticate with a VibeTrader API token.
• Create, list, inspect, start, pause, and delete trading bots.
• Select paper or live trading mode.
• View portfolio positions and recent trade history.
• Retrieve stock or ETF quotes and options chains.
• Backtest strategies against historical data.
• List available strategy templates.

Limitations and notes

This server handles trading-related actions, so live mode requires particular care. Paper mode is documented as the default, but the toolset also permits switching to live trading. The supplied material does not describe order-level controls, risk limits, supported asset coverage beyond the stated stock, ETF, and options data, or the pricing of VibeTrader API access.

The API token is required for authentication. Although the documentation says tokens are not stored on the server, users still need to protect the token they provide to the assistant. The repository includes a hosted endpoint and local run instructions, but it does not provide details about uptime, rate limits, or historical-data coverage.