MCP (AI IDEs)

Overview

The VecTrade MCP server currently provides 42 financial and trading tools to any AI IDE that supports the Model Context Protocol. Supported clients: Claude Code, Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline, Continue.dev.

Quick Setup

Option 1: Hosted (recommended — zero install)

Add this to your IDE’s MCP configuration:

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

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

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

Option 2: Local (stdio via npx)

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

CLI Auto-Setup

If you have the VecTrade CLI:

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

Claude Code: Plugin, Tools, MCP, and Skills

For Claude Code, treat the MCP server as your “plugin” layer:

Add VecTrade MCP server (hosted endpoint or local npx server).
Provide your user API key (vq_...) for market-data tools.
Optionally add Bot key (tvt_...) for trading tools.
Validate setup with vectrade mcp doctor.

Recommended (hosted) for Claude Code

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

Optional Claude Code skill file

If your team uses Claude Code skill prompts, add a repo-level skill such as .claude/skills/vectrade/SKILL.md (template available in the VecTrade MCP repo) with tool-intent patterns:

# VecTrade Skill

- Use `get_quote` for real-time price and volume.
- Use `get_technicals` for RSI/MACD/support-resistance.
- Use `get_news` and `get_sentiment` before proposing a trade thesis.
- For execution, use trading tools only when `VECTRADE_BOT_KEY` is configured.

This keeps Claude Code behavior consistent across teammates while still using the same VecTrade MCP endpoint.

Claude CLI Marketplace Install (one-time)

If you use Claude CLI and want a one-command plugin install path:

claude plugin marketplace add VecTrade-io/vectrade-mcp
claude plugin install vectrade-mcp-plugin@vectrade-tools

What this installs:

vectrade-mcp-plugin skill namespace for consistent trading prompts
plugin-bundled .mcp.json connector (local npx @vectrade/mcp-server)

Required env vars before use:

export VECTRADE_API_KEY=vq_your_key_here
# optional for trading tools
export VECTRADE_BOT_KEY=tvt_your_bot_key

Then verify:

vectrade mcp doctor

For official public directory listing, submit via Anthropic plugin submission flow and community marketplace review.

Works Across Antigravity, VS Code, Cursor, and Claude Code

Yes. The same approach works for all MCP-compatible clients:

Use the same hosted MCP endpoint: https://mcp.vectrade.io/mcp
Pass a user API key in header: X-API-Key: vq_...
Keep a stable server name (recommended: vectrade)
Restart the client so it reloads MCP config
Verify by calling one tool (for example, get_quote)

Client-specific config shapes

Different clients use slightly different JSON keys (mcpServers vs servers).

Config file locations by OS

Use this table to find where to place each config snippet:

Client	macOS	Linux	Windows
Claude Code / Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`	`~/.config/claude/claude_desktop_config.json`	`%APPDATA%/Claude/claude_desktop_config.json`
Cursor	`<project>/.cursor/mcp.json`	`<project>/.cursor/mcp.json`	`<project>/.cursor/mcp.json`
VS Code / GitHub Copilot	`<project>/.vscode/mcp.json`	`<project>/.vscode/mcp.json`	`<project>/.vscode/mcp.json`
Antigravity (MCP-compatible)	Client settings MCP file (project or global)	Client settings MCP file (project or global)	Client settings MCP file (project or global)

If Antigravity exposes both global and workspace MCP config, prefer workspace config for team consistency and easier onboarding.

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

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

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

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

If your Antigravity build uses a different top-level key, keep the same server object (url, headers, X-API-Key) and adapt only the wrapper key expected by that client version.

End-to-End User Guide

1) Get API key

Go to vectrade.io/vtrade/developer
Create or copy your key (vq_...)

2) Add MCP server config

Pick the client block above (Claude Code, Cursor, VS Code, Antigravity)
Add vectrade server with endpoint https://mcp.vectrade.io/mcp
Set X-API-Key

3) Optional trading tools

Add VECTRADE_BOT_KEY=tvt_... only when you need trading execution tools
Keep market-data key (vq_...) and bot key (tvt_...) separate

4) Restart client and verify

Restart IDE/client
Ask: Use get_quote for AAPL
Confirm tool call returns data

5) Run doctor checks (recommended)

vectrade mcp doctor

This validates key format, REST auth, MCP initialize, and tools/list.

Troubleshooting

Symptom	Likely Cause	Fix
`401 Unauthorized`	Missing/invalid `vq_` key	Re-copy key from developer portal and re-save config
`Detected bot key (tvt_...)`	Bot key used as `X-API-Key`	Use `vq_...` for MCP auth; keep `tvt_...` only for trading env var
`Server not initialized`	Client did not preserve MCP session	Reconnect/restart client; ensure client supports Streamable HTTP session flow
`tools/list` returns empty	Key lacks access or upstream issue	Run `vectrade mcp doctor`; verify account plan and API key status
`429 Too Many Requests`	Per-tier rate limit exceeded	Retry after cooldown or upgrade plan
Works in one IDE, fails in another	Different config schema keys	Match client wrapper key (`mcpServers` vs `servers`)
Trading tools unavailable	Missing `VECTRADE_BOT_KEY`	Add valid `tvt_...` key for trading tools
Claude Code not showing tools	Config not reloaded	Restart Claude Code and re-open chat/session

If issues persist, include vectrade mcp doctor output when opening support requests.

Available Tools

Quotes & Market Data

Tool	Description
`get_quote`	Real-time stock quote (price, change, volume)
`get_batch_quotes`	Multiple quotes in one call (up to 50)
`get_historical_prices`	Historical OHLCV data (5d, 1mo, 3mo, 6mo, 1y, 5y)

Fundamentals

Tool	Description
`get_fundamentals`	Key financial metrics (market cap, SMAs)
`get_financial_statements`	Income statement, balance sheet, cash flow
`get_company_profile`	Company info, sector, industry, description

Technical Analysis

Tool	Description
`get_technicals`	Technical score, RSI, MACD, Bollinger, support/resistance

News & Sentiment

Tool	Description
`get_news`	Latest financial news for a symbol
`get_sentiment`	Sentiment score, social mentions (Twitter, Reddit)

Analyst

Tool	Description
`get_analyst_ratings`	Analyst consensus rating (Buy/Hold/Sell)
`get_analyst_targets`	Price target estimates (high, low, mean, median)
`get_upgrades_downgrades`	Recent analyst rating changes

Earnings & Insider

Tool	Description
`get_earnings`	Earnings history with EPS actual vs estimate
`get_insider_transactions`	Insider buy/sell transactions

Options & ETF

Tool	Description
`get_options_chain`	Full options chain (calls & puts)
`get_etf`	ETF info, holdings, sector weights, performance

Trading (Bot API)

Trading tools require a Bot API key (tvt_...) set in VECTRADE_BOT_KEY. See the Bot Trading guide for setup.

Tool	Description
`place_order`	Buy/sell stocks, crypto, forex, ETFs, options
`cancel_order`	Cancel an open order
`get_orders`	List recent orders (filter by status)
`get_portfolio`	Cash balance + all positions with P&L
`get_trading_kpi`	Performance metrics & leaderboard rank
`get_bot_account`	Account info, status & API quota

Trading Setup

To enable AI agent trading, add your Bot API key:

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

Create a Bot API key at vectrade.io/vtrade/developer → Bot API Keys section.

Example Usage

Once configured, ask your AI assistant:

“What’s Apple’s current stock price?”
“Show me the technical analysis for TSLA”
“What are analysts saying about NVDA?”
“Compare insider trading activity for MSFT and GOOG”
“Get the options chain for SPY”
“What ETFs track the S&P 500?”
“Show me AAPL’s historical prices for the past month”
“Buy 10 shares of AAPL” (requires Bot API key)
“How’s my portfolio doing?” (requires Bot API key)
“Set a stop-loss on TSLA at $250” (requires Bot API key)

Verification

Test the connection by asking your AI assistant to call any tool:

“Use the get_quote tool to get the price of AAPL”

If authentication fails, verify your API key is correct and active at vectrade.io/vtrade/developer.

SDKs

Overview

Quick Setup

Option 1: Hosted (recommended — zero install)

Option 2: Local (stdio via npx)

CLI Auto-Setup

Claude Code: Plugin, Tools, MCP, and Skills

Recommended (hosted) for Claude Code

Optional Claude Code skill file

Claude CLI Marketplace Install (one-time)

Works Across Antigravity, VS Code, Cursor, and Claude Code

Client-specific config shapes

Config file locations by OS

End-to-End User Guide

1) Get API key

2) Add MCP server config

3) Optional trading tools

4) Restart client and verify

5) Run doctor checks (recommended)

Troubleshooting

Available Tools

Quotes & Market Data

Fundamentals

Technical Analysis

News & Sentiment

Analyst

Earnings & Insider

Options & ETF

Trading (Bot API)

Trading Setup

Example Usage

Verification

Links

​Overview

​Quick Setup

​Option 1: Hosted (recommended — zero install)

​Option 2: Local (stdio via npx)

​CLI Auto-Setup

​Claude Code: Plugin, Tools, MCP, and Skills

​Recommended (hosted) for Claude Code

​Optional Claude Code skill file

​Claude CLI Marketplace Install (one-time)

​Works Across Antigravity, VS Code, Cursor, and Claude Code

​Client-specific config shapes

​Config file locations by OS

​End-to-End User Guide

​1) Get API key

​2) Add MCP server config

​3) Optional trading tools

​4) Restart client and verify

​5) Run doctor checks (recommended)

​Troubleshooting

​Available Tools

​Quotes & Market Data

​Fundamentals

​Technical Analysis

​News & Sentiment

​Analyst

​Earnings & Insider

​Options & ETF

​Trading (Bot API)

​Trading Setup

​Example Usage

​Verification

​Links

Overview

Quick Setup

Option 1: Hosted (recommended — zero install)

Option 2: Local (stdio via npx)

CLI Auto-Setup

Claude Code: Plugin, Tools, MCP, and Skills

Recommended (hosted) for Claude Code

Optional Claude Code skill file

Claude CLI Marketplace Install (one-time)

Works Across Antigravity, VS Code, Cursor, and Claude Code

Client-specific config shapes

Config file locations by OS

End-to-End User Guide

1) Get API key

2) Add MCP server config

3) Optional trading tools

4) Restart client and verify

5) Run doctor checks (recommended)

Troubleshooting

Available Tools

Quotes & Market Data

Fundamentals

Technical Analysis

News & Sentiment

Analyst

Earnings & Insider

Options & ETF

Trading (Bot API)

Trading Setup

Example Usage

Verification

Links