Alpaca MCP Server

Content

Alpaca MCP Server is Alpaca's official MCP server for the Alpaca Trading API. It uses FastMCP and Alpaca OpenAPI specs to expose account, trading, portfolio, asset, market data, watchlist, news, corporate action, stock, crypto, and options workflows to MCP clients.

Use it for supervised paper-trading, account analysis, portfolio review, market data retrieval, and carefully gated trading workflows. Treat live-trading mode as a financial operations capability that requires human approval and explicit risk controls.

Source Review

• https://github.com/alpacahq/alpaca-mcp-server
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/README.md
• https://pypi.org/pypi/alpaca-mcp-server/json
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/LICENSE
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/pyproject.toml
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/server.json
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/src/alpaca_mcp_server/cli.py
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/src/alpaca_mcp_server/server.py
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/src/alpaca_mcp_server/toolsets.py
• https://raw.githubusercontent.com/alpacahq/alpaca-mcp-server/main/src/alpaca_mcp_server/overrides.py

These sources were reviewed on 2026-06-06. Prefer the live repository, README, PyPI metadata, license, package manifest, MCP registry metadata, CLI entrypoint, FastMCP server builder, toolset definitions, and order override implementation for current setup and behavior details.

Features

• Run as a stdio MCP server with uvx alpaca-mcp-server.
• Configure paper or live trading with ALPACA_PAPER_TRADE.
• Restrict exposed capabilities with ALPACA_TOOLSETS.
• Read account information, account configuration, portfolio history, and account activities.
• Retrieve and manage orders, positions, watchlists, assets, market calendar, market clock, corporate actions, and news.
• Place stock, ETF, crypto, and options orders through curated order tools.
• Retrieve stock, crypto, options, fixed income, and index market data depending on enabled toolsets and account/data access.
• Use OpenAPI-derived tools plus hand-crafted overrides for complex order and market-data endpoints.

Installation

Configure the MCP client with Alpaca credentials. Keep paper trading enabled unless a live-trading workflow is explicitly approved:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "YOUR_ALPACA_API_KEY",
        "ALPACA_SECRET_KEY": "YOUR_ALPACA_SECRET_KEY",
        "ALPACA_PAPER_TRADE": "true",
        "ALPACA_TOOLSETS": "account,stock-data,crypto-data"
      }
    }
  }
}

Claude Code users can add it with:

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server --env ALPACA_API_KEY=YOUR_ALPACA_API_KEY --env ALPACA_SECRET_KEY=YOUR_ALPACA_SECRET_KEY

Set ALPACA_TOOLSETS to the smallest set needed. For data-only use, omit the trading toolset.

Use Cases

• Ask Claude to summarize paper account balances and buying power.
• Retrieve current positions and open orders for review.
• Pull recent stock, crypto, or options market data.
• Check market calendar, market clock, news, and corporate actions.
• Manage watchlists for research workflows.
• Test paper-trading order flows under human supervision.
• Restrict Claude to market-data toolsets for analysis-only sessions.

Safety and Privacy

Alpaca MCP Server can place real trades when configured for live trading. Keep paper mode enabled for experiments, use data-only toolsets whenever possible, and require human confirmation for every trading, cancellation, liquidation, or option-exercise action.

Options, crypto, margin, extended-hours, bracket, stop, trailing-stop, and multi-leg strategies carry significant financial risk. Claude-generated orders are not investment advice and can be wrong, stale, incomplete, or unsuitable for the account.

Alpaca credentials and account data are highly sensitive. Do not paste real API keys into prompts or shared logs. Treat MCP transcripts as financial records when they contain balances, positions, orders, symbols, quantities, prices, portfolio history, activities, or strategy details.

Duplicate Check

Existing entries cover financial research and market data tools such as Drillr and TradingView, but no Alpaca MCP Server, alpacahq/alpaca-mcp-server, alpaca-mcp-server PyPI package, or Alpaca Trading API MCP entry was found in content/mcp.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationraw.githubusercontent.com
• Submitted by oktofeesh12026-06-06