How to Use the Alpaca Trading MCP in Windsurf

Give Windsurf direct access to Alpaca Trading so Cascade can autonomously pull market data and execute trades right in your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alpaca Trading MCP to Windsurf

Create your Vinkius account to connect Alpaca Trading to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Alpaca Trading with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous market execution

Cascade doesn't just read charts. You tell it to balance a portfolio, and it fires off `create_order` calls to buy equities or crypto. If the market tanks, you can instruct the agent to hit `delete_all_orders` to cancel open positions instantly. Traditional trading bots require manual scripting for every edge case. This setup lets you define the strategy in plain English while the AI handles the execution details in the background.

Live data inside your Windsurf MCP Server

Stop tabbing out to Yahoo Finance. Your editor can now hit `get_latest_stocks_quotes` and `get_crypto_bars` to fetch real-time pricing while you build trading algorithms. Cascade reads the returned JSON and injects the exact ticker data into your backtesting script. Historical analysis becomes trivial. Just ask for last week's volume on AAPL, and the agent uses `get_stocks_trades` to pull the exact dataset needed to train your models.

Brokerage operations as code

Managing client accounts usually involves clicking through clunky web portals. Now you can trigger `create_broker_account` to onboard new users, passing identity and disclosure objects programmatically. Adjusting margin settings or trading limits happens through `update_account_configs`. The entire brokerage backend responds to your natural language commands or automated scripts.

Setup guide

Set up Alpaca Trading MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Alpaca Trading MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Alpaca Trading payment history." If connected, Cascade will call the Alpaca Trading tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "alpaca-trading-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Alpaca. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Alpaca Trading now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Alpaca Trading MCP in Windsurf

Open the Settings panel and navigate to the Cascade tab. You can use the built-in marketplace for a one-click install or manually add the server to your configuration file. Hit refresh to load the MCP tools.

Yes. The agent reads your context and can string together multiple actions autonomously. It fetches quotes, calculates position sizing, and submits the orders without you needing to write the API calls.

You get full access to both stock and crypto metrics. Tools exist for historical bars, trades, and quotes across all supported assets. The agent formats this data directly into your workspace.

Paper trading works perfectly. Just provide your paper API keys when configuring the MCP connection. Your agent will trade simulated money using live market data.

Vinkius handles the connection through a zero-trust V8 Isolate Sandbox. When you pass sensitive objects like contact info, identity documents, and disclosures for account creation, that data routes directly to the broker. The server runs ephemerally and retains nothing.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript