Alpaca MCP Server

🚀 Alpaca MCP Server

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

🚀 Quick Start

This Alpaca MCP Server allows seamless interaction between LLMs and Alpaca's trading API. With natural - language support, users can perform various trading - related operations effortlessly.

✨ Features

• 📊 Market Data - Obtain real - time stock quotes and historical price data.
• 💵 Account Information - View 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 3.10+
• Alpaca API keys
• Claude for Desktop or another MCP client

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 and add your Alpaca API credentials:

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key
   

💻 Usage Examples

Running the Server

Start the server by running the following command:

python alpaca_mcp_server.py

Configuring Claude for Desktop

1. Open Claude for Desktop.
2. Go to Settings.
3. Click "Developer", then click "Edit Configuration".
4. Add the server configuration to claude_desktop_config.json:

{
  "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 and restart Claude for Desktop.

Available Tools

The server exposes the following tools:

• get_account_info() - Get account information.
• 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 open orders.
• close_all_positions(cancel_orders) - Close all positions.

Example Queries

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

• "What are 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 MSFT at market price."
• "Sell 10 shares of TSLA at price X."
• "Cancel all open orders."

📚 Documentation

Notes

• This server requires valid Alpaca API keys to function properly.
• When using this tool in a production environment, it is recommended to carefully review the code and ensure security.

Security Tips

Always review the instructions sent through this server to prevent unauthorized trades or operations.