@tradewink/mcp

Connect any LLM to the Tradewink autonomous trading platform via the Model Context Protocol.

Get real-time quotes, manage your portfolio, execute trades, run AI analysis, and more — all from your AI assistant.

Quick Start

1. Get an API Key

Sign up at tradewink.com and generate an API key in your dashboard.

2. Configure Your Client

Automatic Setup (Recommended)

Auto-detect and configure all your installed AI clients with one command:

TRADEWINK_API_KEY=tw_your_key_here npx @tradewink/mcp setup

This detects and configures: Claude Code, Claude Desktop, VS Code (Copilot), Cursor, Windsurf, and OpenAI Codex CLI.

Manual Setup

claude mcp add tradewink -e TRADEWINK_API_KEY=tw_your_key_here -- npx -y @tradewink/mcp

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tradewink": {
      "command": "npx",
      "args": ["-y", "@tradewink/mcp"],
      "env": {
        "TRADEWINK_API_KEY": "tw_your_key_here"
      }
    }
  }
}

Add to your VS Code settings (.vscode/settings.json or global settings):

{
  "mcp": {
    "servers": {
      "tradewink": {
        "command": "npx",
        "args": ["-y", "@tradewink/mcp"],
        "env": {
          "TRADEWINK_API_KEY": "tw_your_key_here"
        }
      }
    }
  }
}

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "tradewink": {
      "command": "npx",
      "args": ["-y", "@tradewink/mcp"],
      "env": {
        "TRADEWINK_API_KEY": "tw_your_key_here"
      }
    }
  }
}

codex mcp add tradewink -- npx -y @tradewink/mcp
export TRADEWINK_API_KEY=tw_your_key_here

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tradewink": {
      "command": "npx",
      "args": ["-y", "@tradewink/mcp"],
      "env": {
        "TRADEWINK_API_KEY": "tw_your_key_here"
      }
    }
  }
}

Any client that supports MCP stdio servers works:

TRADEWINK_API_KEY=tw_xxx npx @tradewink/mcp

3. Start Using It

Ask your AI assistant things like:

• "What's my account balance?"
• "Show me my open positions"
• "Get a quote for AAPL"
• "What are today's top market movers?"
• "Analyze NVDA with AI"
• "Add TSLA to my watchlist"
• "What are my active trading strategies?"
• "Show my trade history for the past week"

Available Tools

| Category | Tools | |----------|-------| | Account | get_account, get_positions, get_portfolio_live | | Watchlist | get_watchlist, add_to_watchlist, remove_from_watchlist | | Market Data | get_quote, batch_quote, get_historical, get_news, get_analyst_ratings, get_earnings, get_technical_analysis | | Screener | get_market_movers, get_screener_results | | Trading | place_order, close_position, get_open_orders, cancel_order | | Strategies | get_strategies, get_strategy, get_exit_strategies, get_sell_confidence | | Trade History | get_trades, get_trade_analytics, get_trade_executions, get_audit_log | | AI Analysis | ask_ai, analyze_ticker, get_insights | | Preferences | get_preferences, list_preference_options, update_preference, reset_preference | | Scheduling | schedule_analysis, list_scheduled_jobs, cancel_scheduled_job |

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | TRADEWINK_API_KEY | Yes | — | Your Tradewink API key (tw_...) | | TRADEWINK_ENDPOINT | No | https://tradewink-mcp.fly.dev/mcp | Custom MCP server endpoint |

You can also pass --endpoint as a CLI argument:

TRADEWINK_API_KEY=tw_xxx npx @tradewink/mcp --endpoint https://custom.example.com/mcp

API Key Permissions

API keys have three permission levels:

| Level | Access | |-------|--------| | read | Market data, portfolio, strategies, trade history | | trade | Everything in read + order execution, watchlist management | | admin | Full access including agent configuration |

Generate keys with the appropriate permission level in your dashboard.

How It Works

This package runs a local MCP server over stdio and proxies all requests to the remote Tradewink MCP server over HTTP. Your API key is sent as a Bearer token — it never leaves the connection between your machine and Tradewink's servers.

Your LLM Client ←stdio→ @tradewink/mcp ←HTTPS→ Tradewink MCP Server

License

MIT