Tradewink

@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. Configure Your Client

No API key needed — @tradewink/mcp uses OAuth 2.1. The first time you run it, a browser window opens to authorize your tradewink.com account. Tokens are cached in ~/.tradewink/mcp/ and refresh automatically.

Automatic Setup (Recommended)

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

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

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

codex mcp add tradewink -- npx -y @tradewink/mcp

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

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

Any client that supports MCP stdio servers works:

npx @tradewink/mcp

2. 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

Configuration

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

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

Auth

OAuth 2.1 is the default. On first run a browser window opens to tradewink.com/mcp/authorize, you approve the request, and the bridge caches an access + refresh token pair at ~/.tradewink/mcp/<host>.json. Access tokens live for 1 hour and refresh automatically for 60 days. You can revoke access anytime from your dashboard.

Set TRADEWINK_API_KEY=tw_... to skip OAuth and use a manual key (e.g. for CI, sandboxes, or pinned long-lived access).

How It Works

This package runs a local MCP server over stdio and proxies every tool/resource call to the remote Tradewink MCP server over HTTPS. OAuth tokens are minted per-device and scoped to your account.

Your LLM Client ←stdio→ @tradewink/mcp ←HTTPS (Bearer token)→ Tradewink MCP Server

License

MIT