The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Tradewink listing page.
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.
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.
Auto-detect and configure all your installed AI clients with one command:
This detects and configures: Claude Code, Claude Desktop, VS Code (Copilot), Cursor, Windsurf, and OpenAI Codex CLI.
Add to your claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd to your VS Code settings (.vscode/settings.json or global settings):
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
Add to ~/.codeium/windsurf/mcp_config.json:
Any client that supports MCP stdio servers works:
Ask your AI assistant things like:
| 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 |
| Environment Variable | Required | Default | Description |
|---|---|---|---|
TRADEWINK_API_KEY | No | — | Skip the OAuth flow and use a manual API key (tw_...). Useful for headless CI. |
TRADEWINK_ENDPOINT | No | https://tradewink-mcp.fly.dev/mcp | Custom MCP server endpoint |
You can also pass --endpoint as a CLI argument:
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).
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.
MIT