Skip to main content
Glama
Alpaca Trading MCP Server

Alpaca Trading MCP Server

by laukikk

Alpaca Trading MCP Server

A Model Context Protocol (MCP) server that provides an interface to the Alpaca trading API, allowing you to manage your stock and crypto portfolio, place trades, and access market data.

Features

  • Account Management: View account details, balances, and portfolio status

  • Trading: Place market, limit, stop, and stop-limit orders

  • Portfolio Management: View positions, calculate performance, and close positions

  • Market Data: Access real-time quotes and historical price data

  • Asset Information: Get details about tradable assets

Related MCP server: Alpaca MCP Server

Installation

Installing via Smithery

To install Alpaca Trading MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @laukikk/alpaca-mcp --client claude

Manual Installation

  1. Clone this repository

  2. Install dependencies:

pip install -e .

Or using uv:

uv pip install -e .

Configuration

  1. Copy the .env.example file to .env:

cp .env.example .env
  1. Add your Alpaca Paper Trading API credentials to the .env file:

ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

You can obtain these credentials by creating an account at Alpaca.

Usage

Run the MCP server:

python src/server.py

The server will start and be available for MCP clients to connect to.

Testing with Claude for Desktop

Configuration:

Open your Claude for Desktop App configuration in a text editor. Create the file if it doesn't exist.

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the Alpaca MCP server configuration:

{
    "mcpServers": {
        "alpaca": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
                "run",
                "src/server.py"
            ]
        }
    }
}

MCP For Server Developers: Quickstart

Available Resources

The server provides the following resources:

  • account://info - Get current account information

  • positions://all - Get all current positions

  • positions://{symbol} - Get position details for a specific symbol

  • orders://recent/{limit} - Get most recent orders with specified limit

  • market://{symbol}/quote - Get current market quote for a specific symbol

  • market://{symbol}/bars/{timeframe} - Get historical price bars for a symbol with specified timeframe

  • assets://list - List tradable assets available on Alpaca

  • assets://{symbol} - Get detailed asset information by symbol

Available Tools

The server provides the following tools:

  • get_account_info_tool - Get current account information

  • place_market_order - Place a market order to buy or sell a stock

  • place_limit_order - Place a limit order to buy or sell a stock at a specified price

  • place_stop_order - Place a stop order to buy or sell a stock when it reaches a specified price

  • place_stop_limit_order - Place a stop-limit order combining stop and limit order features

  • cancel_order - Cancel an open order by its ID

  • close_position - Close an open position for a specific symbol

  • get_portfolio_summary - Get a comprehensive summary of the portfolio

Available Tools

8 tools
cancel_orderB

Cancel an open order by its ID.

Args: order_id: ID of the order to cancel

Returns: Confirmation of cancellation

Inputs: order_id (required).

close_positionC

Close an open position for a specific symbol.

Args: symbol: Stock symbol to close position for

Returns: Confirmation of position closure

Inputs: symbol (required).

get_account_info_toolB

Get current account information.

Returns: Account summary with balance and status

Inputs: no named parameters.

get_portfolio_summaryB

Get a comprehensive summary of the portfolio including account details and open positions.

Returns: Portfolio summary with account and positions information

Inputs: no named parameters.

place_limit_orderB

Place a limit order to buy or sell a stock at a specified price.

Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' limit_price: Maximum price for buy or minimum price for sell time_in_force: Order duration - 'day', 'gtc' (good till canceled), 'ioc' (immediate or cancel)

Returns: Order confirmation details

Inputs: symbol (required), quantity (required), side (required), limit_price (required), +1 more.

place_market_orderB

Place a market order to buy or sell a stock.

Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell'

Returns: Order confirmation details

Inputs: symbol (required), quantity (required), side (required).

place_stop_limit_orderA

Place a stop-limit order combining stop and limit order features.

Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' stop_price: Price that triggers the order limit_price: Maximum/minimum price for the triggered order time_in_force: Order duration - 'day', 'gtc' (good till canceled)

Returns: Order confirmation details

Inputs: symbol (required), quantity (required), side (required), stop_price (required), +2 more.

place_stop_orderA

Place a stop order to buy or sell a stock when it reaches a specified price.

Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' stop_price: Price that triggers the order time_in_force: Order duration - 'day', 'gtc' (good till canceled)

Returns: Order confirmation details

Inputs: symbol (required), quantity (required), side (required), stop_price (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. Order placement tools (market, limit, stop, stop-limit) are well-differentiated by order type, while account/portfolio tools and order/position management tools serve separate functions. An agent can easily distinguish between them based on their specific actions.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., cancel_order, close_position, place_market_order). However, get_account_info_tool deviates slightly with the '_tool' suffix, breaking perfect consistency. The naming is otherwise predictable and readable across the set.

    Tool Count5/5

    With 8 tools, this server is well-scoped for trading operations. It covers essential functions like order placement (4 tools), order cancellation, position management, and account/portfolio queries. Each tool earns its place without being overly sparse or bloated for the domain.

    Completeness4/5

    The toolset provides strong coverage for core trading workflows: placing various order types, managing orders and positions, and viewing account/portfolio data. A minor gap exists in the lack of tools for modifying existing orders or retrieving specific order details, but agents can work around this with the available tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server enabling LLMs like Claude to interact with the Alpaca trading API through natural language for stock trading, checking positions, fetching market data, and managing your account.
      28
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server implementation for Alpaca's Trading API that enables LLMs to interact with Alpaca's trading infrastructure using natural language, supporting stock, options, and crypto trading, portfolio management, watchlists, and market data.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides financial trading tools and market analysis capabilities, enabling AI assistants to access real-time market data, execute trades, analyze portfolios, and perform comprehensive financial analysis.
      MIT