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

Installation

1. Clone this repository

2. Install dependencies:

Or using uv:

Configuration

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

2. Add your Alpaca Paper Trading API credentials to the .env file:

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

Usage

Run the MCP server:

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

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