Vega Trader MCP Server

Connect Cursor, Claude Desktop, or any MCP-compatible AI assistant to your Vega Trader account. Analyze portfolios, review trades, scan options, and manage watchlists through natural language.

MCP endpoint: https://vega-trader.com/mcp

What is the MCP server?

The Model Context Protocol (MCP) lets AI assistants call Vega Trader tools on your behalf. Instead of exporting spreadsheets or copying data into a chat window, your assistant can query your real trade journal, run analytics, and take actions like creating alerts — always scoped to your account.

What can it do?

The server exposes 46 tools across portfolio analysis, trade coaching, market data, options scanning, strategy building, risk reports, and more. Highlights include:

Portfolio & positions

get_portfolio, get_positions, simulate_portfolio, analyze_portfolio — open positions, P/L, Greeks exposure, and AI-friendly risk summaries.

Trade history & coaching

get_trade_history, analyze_trade_history, coach_me, get_dashboard — win rate, expectancy, coaching notes, and performance stats.

Market & options

get_market_snapshot, market_regime, scan_unusual_options, get_option_chain — indices, VIX context, and unusual activity.

Strategies

find_option_strategies, build_strategy, explain_strategy — match structures to your outlook (iron condor, calendar, straddle, and more).

Risk analysis

stress_test, greeks_analysis, risk_report — scenario analysis and exportable risk reports.

Watchlists, alerts & automation

create_watchlist, create_alert, weekly_report, natural_language_search, create_automation — write tools for alerts and recurring workflows.

Authentication

Every personal tool requires authentication. You can connect using either method below:

JWT — sign in to Vega Trader and pass your session token as Authorization: Bearer <token>. Best for quick testing.
API key — use X-API-Key: vt_mcp_... or Authorization: Bearer vt_mcp_... . Best for Cursor, Claude Desktop, and long-lived integrations.
Without auth, only public catalog tools are available (search_underlyings, list_catalog_strategies, etc.).

Quick start with curl

The server speaks JSON-RPC 2.0 over HTTP. Tool results are returned as JSON inside result.content[0].text.

Ping (no authentication required)

curl -s -X POST https://vega-trader.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

List available tools

curl -s -X POST https://vega-trader.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_mcp_YOUR_KEY_HERE" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Analyze your portfolio

curl -s -X POST https://vega-trader.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_mcp_YOUR_KEY_HERE" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"analyze_portfolio","arguments":{}}}'

Connect your AI assistant

Add the MCP server in your client settings using the endpoint above and your API key.

Cursor

In Cursor, open Settings → MCP and add a remote server, or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "vega-trader": {
      "url": "https://vega-trader.com/mcp",
      "headers": {
        "X-API-Key": "vt_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop & other MCP clients

In Claude Desktop or VS Code MCP extensions, configure a remote HTTP server with the same URL and X-API-Key header. Refer to your client's documentation for remote MCP setup.

Built-in prompts

When authenticated, you can also use prompts/get with reusable conversation starters:

portfolio_review
risk_analysis
trade_review
strategy_recommendation
market_summary
weekly_coaching

Example questions to ask your assistant

Once connected, try prompts like:

Review my portfolio and flag concentration risk before expiration.
Analyze my closed trades from the last 90 days and tell me my biggest mistakes.
What iron condor setups match a neutral, high-IV outlook on SPY?
Create a watchlist called Earnings with NVDA and TSLA.

Important notes

Vega Trader is a trade journal, not a broker. Portfolio tools reflect your logged trades and open journal positions — not broker buying power, cash, or margin.
Live Greeks and option chains require an Essential plan with market data access.
You only ever access your own data. All requests are rate-limited and audit-logged.

Security

Keep your API key secret — treat it like a password. Revoke compromised keys by contacting support. MCP requests are isolated per user, validated on every call, and subject to rate limits.

Vega trader