alpaca-mcp-server MCP server

Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEs

What alpaca-mcp-server does

Summarised from the project README; check the repository for the latest details.

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.

Tools exposed (20+)

• get_account_info – Balance, margin, and account status
• get_account_config – Trading restrictions, margin settings, PDT checks
• update_account_config – Update account configuration settings
• get_portfolio_history – Equity and P/L over time
• get_account_activities – Fills, dividends, transfers
• get_account_activities_by_type – Activities filtered by type
• get_orders – Retrieve orders with filters
• get_order_by_id – Single order by ID
• get_order_by_client_id – Single order by client order ID
• replace_order_by_id – Replace an existing open order
• cancel_order_by_id – Cancel a specific order
• cancel_all_orders – Cancel all open orders
• place_stock_order – Stocks/ETFs (market, limit, stop, stop-limit, trailing-stop, brackets)
• place_crypto_order – Crypto (market, limit, stop-limit)
• place_option_order – Options (single-leg or multi-leg)
• get_all_positions – All current positions
• get_open_position – Details for a specific position
• close_position – Close a specific position
• close_all_positions – Liquidate entire portfolio
• exercise_options_position – Exercise a held option contract

Requirements

• Python 3.10+ (installation guide)
• uv (installation guide)
• Alpaca Trading API keys (free paper trading account)
• MCP client (Claude Desktop, Cursor, VS Code, etc.)
• Python with uv (runs with uvx/uv)
• Environment variables: ALPACA_API_KEY, ALPACA_SECRET_KEY

How to install alpaca-mcp-server MCP in Claude Desktop, Cursor and VS Code

claude mcp add --env ALPACA_API_KEY=your_alpaca_api_key --env ALPACA_SECRET_KEY=your_alpaca_secret_key --transport stdio alpaca -- uvx alpaca-mcp-server

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

{
  "servers": {
    "alpaca": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Add to config generator – combine it with other servers, or get the Windsurf format.

Featured in: Best MCP servers for crypto and Web3

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/alpacahq-alpaca-mcp-server/)

Maintain this project? Get it featured for free during launch →

Compare with FinanceToolkit →

Related Finance & Crypto MCP servers