Package Exports

@tradewink/mcp
@tradewink/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@tradewink/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

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 Code

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

Claude Desktop

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"
      }
    }
  }
}

VS Code (Copilot)

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"
        }
      }
    }
  }
}

Cursor

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"
      }
    }
  }
}

OpenAI Codex CLI

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

Windsurf

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

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

Any MCP-Compatible Client

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