Tradewink
MCP for Tradewink trading signals and watchlists. Not financial advice.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http tradewink 'https://tradewink-mcp.fly.dev/mcp' --header 'Authorization: <Bearer token from Tradewink (Authorization: Bearer <token>)>'
{
"mcpServers": {
"tradewink": {
"type": "http",
"url": "https://tradewink-mcp.fly.dev/mcp",
"headers": {
"Authorization": "<Bearer token from Tradewink (Authorization: Bearer <token>)>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
@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 Code
claude mcp add tradewink -- 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"]
}
}
}
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"]
}
}
}
OpenAI Codex CLI
codex mcp add tradewink -- npx -y @tradewink/mcp
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"tradewink": {
"command": "npx",
"args": ["-y", "@tradewink/mcp"]
}
}
}
Any MCP-Compatible Client
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
| 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 | 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:
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
Frequently asked questions
What is Tradewink?
MCP for Tradewink trading signals and watchlists. Not financial advice.
How do I install Tradewink?
It runs as a remote server. In Claude Code: claude mcp add --transport http tradewink 'https://tradewink-mcp.fly.dev/mcp' --header 'Authorization: <Bearer token from Tradewink (Authorization: Bearer <token>)>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Tradewink need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Tradewink open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Tradewink?
It is published by leancoderkavy. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.