Alpaca MCP

A comprehensive Model Context Protocol (MCP) server for Alpaca's Trading API. Enable natural language trading operations through AI assistants like Claude, Cursor, and VS Code. Supports stocks, options, crypto, portfolio management, and real-time market data.

Features

• Market Data — Real-time quotes, trades, and price bars for stocks, crypto, and options. Historical data with flexible timeframes. Option Greeks and implied volatility.
• Account Management — View balances, buying power, account status, and portfolio history.
• Order Management — Place market, limit, stop, stop-limit, and trailing-stop orders for stocks, crypto, and options. Cancel orders individually or in bulk.
• Options Trading — Search contracts by expiration/strike/type. Place single-leg or multi-leg strategies. Get latest quotes, Greeks, and IV.
• Crypto Trading — Market, limit, and stop-limit orders with GTC/IOC. Quantity or notional-based.
• Position Management — View, close, or liquidate positions. Exercise option contracts.
• News — News articles filterable by ticker and date range.
• Market Status — Market open/close times, calendar, corporate actions.
• Watchlists — Create, update, and manage watchlists.
• Asset Search — Query details for stocks, ETFs, crypto, and options with filtering.

Available Tools

Account & Portfolio: get_account_info, get_account_config, update_account_config, get_portfolio_history, get_account_activities, get_account_activities_by_type

Trading (Orders): get_orders, get_order_by_id, get_order_by_client_id, replace_order_by_id, cancel_order_by_id, cancel_all_orders, place_stock_order, place_crypto_order, place_option_order

Positions: get_all_positions, get_open_position, close_position, close_all_positions, exercise_options_position, do_not_exercise_options_position

Watchlists: create_watchlist, get_watchlists, get_watchlist_by_id, update_watchlist_by_id, delete_watchlist_by_id, add_asset_to_watchlist_by_id, remove_asset_from_watchlist_by_id

Assets & Market Info: get_all_assets, get_asset, get_option_contracts, get_option_contract, get_calendar, get_clock, get_corporate_action_announcements, get_corporate_action_announcement

Stock Data: get_stock_bars, get_stock_quotes, get_stock_trades, get_stock_latest_bar, get_stock_latest_quote, get_stock_latest_trade, get_stock_snapshot, get_most_active_stocks, get_market_movers

Crypto Data: get_crypto_bars, get_crypto_quotes, get_crypto_trades, get_crypto_latest_bar, get_crypto_latest_quote, get_crypto_latest_trade, get_crypto_snapshot, get_crypto_latest_orderbook

Options Data: get_option_bars, get_option_trades, get_option_latest_trade, get_option_latest_quote, get_option_snapshot, get_option_chain, get_option_exchange_codes

Corporate Actions & News: get_corporate_actions, get_news

Toolset Filtering

You can limit the server to specific toolsets via ALPACA_TOOLSETS (comma-separated): account, trading, watchlists, assets, stock-data, crypto-data, options-data, corporate-actions, news.

Configuration

All configuration is through environment variables:

• ALPACA_API_KEY (required): Your Alpaca API key
• ALPACA_SECRET_KEY (required): Your Alpaca secret key
• ALPACA_PAPER_TRADE (optional, default true): Set to false for live trading
• ALPACA_TOOLSETS (optional): Comma-separated list of toolsets to enable

Disclaimer

This server can place real trades and access your portfolio. Insights are for educational purposes only and should not be taken as investment advice. Options trading involves high risk. Always conduct your own due diligence.