@tradewink/mcp

Connect any LLM to Tradewink signals and analysis via the Model Context Protocol, then pair it with Alpaca for agent-driven execution.

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"

Related MCP server: MetaTrader 5 MCP Server

Tradewink Signals + Alpaca Execution

Use tradewink-mcp as the signal and research layer for your agent, and the official Alpaca MCP server as the execution layer. This keeps Tradewink's market context, screeners, technical analysis, and AI insights separate from the broker tools that place orders.

This is an integration pattern: no Alpaca order-execution code is added to tradewink-mcp.

Add both servers to the same Claude Desktop or Cursor MCP configuration:

{
  "mcpServers": {
    "tradewink": {
      "command": "npx",
      "args": ["-y", "@tradewink/mcp"]
    },
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_paper_api_key",
        "ALPACA_SECRET_KEY": "your_paper_secret_key",
        "ALPACA_PAPER_TRADE": "true"
      }
    }
  }
}

The official Alpaca server uses uvx and defaults to paper trading; the explicit ALPACA_PAPER_TRADE setting above makes the safety boundary visible. Create paper keys in Alpaca's dashboard and keep credentials in your local MCP client configuration. See the Alpaca MCP setup and configuration docs.

Example agent workflow

Ask the agent to:

1. Get a Tradewink signal, such as market movers plus get_technical_analysis or analyze_ticker for AAPL.

2. Check the current quote and paper-account buying power, define a maximum loss/risk budget, and size the position from that budget rather than blindly copying a signal.

3. If the thesis and sizing pass review, place a paper order with Alpaca's place_stock_order, then report the order details and risk controls.

For example: “Use Tradewink to find a bullish AAPL setup, explain the signal and invalidation level, size it to no more than 1% of my paper account, and—only after I confirm—place the corresponding paper order through Alpaca.”

Tradewink signals are informational and may be incomplete, delayed, or wrong. Trading involves substantial risk, including loss of principal; an agent can misunderstand data or instructions. Review every signal, size, and order yourself, and do not switch ALPACA_PAPER_TRADE to false until you understand and accept the risks.

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