Miguelyad26 Alpaca MCP Server

🚀 Alpaca MCP Server

This is a server that provides the Model Context Protocol (MCP) for Alpaca, enabling large language models (LLMs) like Claude to interact with Alpaca's trading API. It supports stock trading, position viewing, market data retrieval, and account management—all through natural language.

🚀 Quick Start

This Alpaca MCP server allows seamless interaction between large language models and Alpaca's trading API. With it, you can perform various trading - related operations using natural language.

✨ Features

• 📚 Alpaca Documentation Access - Access Alpaca SDK documentation for development.
• 📊 Market Data - Get real - time stock quotes and historical price data.
• 💵 Account Information - View account balance, buying power, and account status.
• 📈 Position Management - Check current positions and their performance.
• 🛒 Order Placement - Place market and limit orders via natural language.
• 📋 Order Management - List, track, and cancel orders.

📦 Installation

Prerequisites

• Python version 3.10 or higher.
• Alpaca API credentials.
• Claude for Desktop or other MCP clients.

Steps

1. Clone this repository:

   git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git
   cd alpaca-mcp
   

2. Install the required packages:

   pip install mcp alpaca-py python-dotenv
   

3. Create a .env file containing your Alpaca API credentials:

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key
   

💻 Usage Examples

Running the Server

To start the server, run the following command:

python alpaca_mcp_server.py

Configuring Claude for Desktop

1. Open Claude for Desktop.

2. Go to Settings.

3. Click "Developer" and then select "Edit Configuration".

4. Add the server configuration to the claude_desktop_config.json file:

   {
     "mcpServers": {
       "alpaca": {
         "command": "python",
         "args": [
           "/path/to/alpaca_mcp_server.py"
         ],
         "env": {
           "API_KEY_ID": "your_alpaca_api_key",
           "API_SECRET_KEY": "your_alpaca_secret_key"
         }
       }
     }
   }
   

5. Save the changes and restart Claude for Desktop.

Available Tools

The server provides the following tools:

• get_account_info() - Get account balance and status.
• get_positions() - List current positions.
• get_stock_quote(symbol) - Get the latest quote for a stock.
• get_stock_bars(symbol, days) - Get historical price data for a stock.
• get_orders(status, limit) - List orders with a specified status.
• place_market_order(symbol, side, quantity) - Place a market order.
• place_limit_order(symbol, side, quantity, limit_price) - Place a limit order.
• cancel_all_orders() - Cancel all pending orders.
• close_all_positions(cancel_orders) - Close all positions (optionally cancel related orders).

Example Queries

Once the server is connected to Claude, you can ask the following questions:

• "What is my current account balance and buying power?"
• "Show my current positions."
• "Get the latest quote for AAPL."
• "Show the price trend of TSLA over the past 10 days."
• "Buy 5 shares of Microsoft (MSFT)."
• "Sell 10 shares of Amazon (AMZN) at a limit price of $130."
• "Cancel all pending orders."

📚 Documentation

Note

By default, the server uses Alpaca's paper trading feature. If you want to trade with real money, change paper=True to paper=False when initializing the TradingClient.

Security Tip

This MCP server can access your Alpaca account and execute real - world trades. Always double - check Claude's suggestions to ensure the approved trades meet your expectations.

📄 License

MIT