Tradewink
MCP for Tradewink trading signals and watchlists. Not financial advice.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
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>)>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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
الأسئلة الشائعة
ما هو Tradewink؟
MCP for Tradewink trading signals and watchlists. Not financial advice.
كيف أثبّت Tradewink؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http tradewink 'https://tradewink-mcp.fly.dev/mcp' --header 'Authorization: <Bearer token from Tradewink (Authorization: Bearer <token>)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Tradewink إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Tradewink مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Tradewink؟
ينشره leancoderkavy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.