AlpacaSAFE

This is a Model Context Protocol (MCP) server for Alpaca, allowing LLMs like Claude to interact with the Alpaca trading API. It enables trading stocks, checking positions, fetching market data, and managing your account - all through natural language.

Features

• 📊 Market Data - Get real-time stock quotes and historical price data
• 💵 Account Information - Check your balances, buying power, and status
• 📈 Position Management - View current positions and their performance
• 🛒 Order Placement - Place market and limit orders through natural language
• 📋 Order Management - List, track, and cancel orders

Prerequisites

• Python 3.10+
• Alpaca API keys
• Claude for Desktop or another MCP client

Installation

1. Clone this repository:

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

1. Install the required packages:

pip install mcp alpaca-py python-dotenv

1. Create a .env file with your Alpaca API credentials:

API_KEY_ID=your_alpaca_api_key
API_SECRET_KEY=your_alpaca_secret_key

Usage

Running the server

Start the server by running:

python alpaca_mcp_server.py

Configuring Claude for Desktop

1. Open Claude for Desktop
2. Go to Settings
3. Click on "Developer" and then "Edit Config"
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"
}
}
}
}

1. Save and restart Claude for Desktop

Available Tools

The server exposes the following tools:

• get_account_info() - Get account balances and status
• get_positions() - List all current positions in the portfolio
• get_stock_quote(symbol) - Get the latest quote for a stock
• `get_st