VecTrade MCP Integration Kit

Zero-config setup for VecTrade financial tools in AI IDEs.

27 financial tools available in Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline, and any MCP-compatible client.

Installation

pip install vectrade-mcp

Or with uvx:

uvx vectrade-mcp-setup

To use the unified CLI directly after install:

vectrade mcp setup claude-code
vectrade mcp doctor

For development:

pip install -r requirements.txt

Quick Setup (60 seconds)

Option 1: Interactive Setup

python -m vectrade_mcp.setup_wizard
# or, if installed:
vectrade-mcp-setup

Option 2: Manual Configuration

Copy the appropriate config for your IDE:

Option 3: CLI Auto-Setup

vectrade mcp setup cursor
vectrade mcp setup claude-code
vectrade mcp setup vscode

Compatibility aliases also work:

vectrade mcp setup claude
vectrade setup claude-code

What You Get

Once configured, your AI assistant can:

• "What's AAPL trading at?" → Real-time quotes
• "Analyze NVDA before earnings" → AI-powered analysis
• "Find undervalued large caps with dividend > 3%" → Stock screening
• "Show me the AAPL options chain" → Options data
• "Compare MSFT vs GOOGL fundamentals" → Side-by-side comparison
• "Buy 10 shares of AAPL" → AI agent trading (Bot API)
• "How's my portfolio doing?" → Portfolio & KPI tracking

See TOOLS.md for the full list of available tools.

AI Agent Trading (NEW)

Give your AI assistant a trading account! With a Bot API key (tvt_...), Claude/GPT can autonomously place orders, manage portfolios, and compete on the leaderboard.

{
  "mcpServers": {
    "vectrade": {
      "command": "npx",
      "args": ["-y", "@vectrade/mcp-server"],
      "env": {
        "VECTRADE_API_KEY": "vq_live_...",
        "VECTRADE_BOT_KEY": "tvt_your_bot_key"
      }
    }
  }
}

Trading tools: place_order, cancel_order, get_orders, get_portfolio, get_trading_kpi, get_bot_account

See guides/bot-trading for full docs.

Verify Connection

export VECTRADE_API_KEY=vq_live_...
vectrade mcp doctor

Legacy verification command is still available:

python -m vectrade_mcp.verify
vectrade-mcp-verify
vectrade-mcp-doctor

Development

pip install -r requirements.txt
pytest --cov=vectrade_mcp --cov-report=term-missing
ruff check .

See CONTRIBUTING.md for details.

Requirements

• Node.js 18+ (for npx execution)
• VecTrade API key (get one free)

Hosted MCP (Zero Install)

Use VecTrade's hosted MCP server — no local setup needed. Just add the remote URL to your IDE config:

Streamable HTTP (recommended):

{
  "mcpServers": {
    "vectrade": {
      "url": "https://mcp.vectrade.io/mcp",
      "headers": {
        "X-API-Key": "vq_live_..."
      }
    }
  }
}

Legacy SSE:

{
  "mcpServers": {
    "vectrade": {
      "url": "https://mcp.vectrade.io/sse",
      "headers": {
        "X-API-Key": "vq_live_..."
      }
    }
  }
}

The hosted server uses the same API key authentication and plan limits as the REST API.

Self-Hosting

To run the MCP server on your own infrastructure:

# Build and run
npm run build
PORT=3200 VECTRADE_API_KEY=vq_live_... npm start         # Streamable HTTP
PORT=3200 VECTRADE_API_KEY=vq_live_... npm run start:sse  # Legacy SSE

# Docker
docker build -t vectrade-mcp .
docker run -p 3200:3200 -e VECTRADE_API_KEY=vq_live_... vectrade-mcp

Documentation

Full docs at docs.vectrade.io/mcp.

Operational and policy docs in this repo:

• MCP_RUNBOOK.md
• PRIVACY.md
• SUPPORT_SLA.md
• CLAUDE_CODE_MARKET_SUBMISSION_GUIDE.md

Community

• 💬 Discord — Get help, share prompts, discuss MCP workflows
• 📖 MCP Directory — Discover other MCP servers
• 🐍 finkit — Open-source indicators library (no API key needed)
• ⭐ Star this repo to help others find it!

License

MIT — see LICENSE.