tedlikeskix/alpaca-mcp-server

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:
bash
git clone https://github.com/YOURUSERNAME/alpaca-mcp.git
cd alpaca-mcp
2. Install the required packages:
bash
pip install mcp alpaca-py python-dotenv
3. Create a .env file with your Alpaca API credentials:
APIKEYID=youralpacaapikey
APISECRETKEY=youralpacasecretkey
## Usage
### Running the server
Start the server by running:
bash
python alpacamcpserver.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 claudedesktopconfig.json:
json
"mcpServers": {
"alpaca": {
"command": "python",
"args": [
"/path/to/alpacamcpserver.py"
],
"env": {
"APIKEYID": "youralpacaapikey",
"APISECRETKEY": "youralpacasecretkey"
5. Save and restart Claude for Desktop
### Available Tools
The server exposes the following tools:
getaccountinfo() - Get account balances and status
getpositions() - List all current positions in the portfolio
getstockquote(symbol) - Get the latest quote for a stock
getstockbars(symbol, days) - Get historical price bars for a stock
getorders(status, limit) - List orders with specified status
placemarketorder(symbol, side, quantity) - Place a market order
placelimitorder(symbol, side, quantity, limitprice) - Place a limit order
cancelallorders() - Cancel all open orders
closeallpositions(cancelorders) - Close all open positions
## Example Queries
Once the server is connected to Claude, you can ask questions like:
"What's my current account balance and buying power?"
"Show me my current positions"
"Get the latest quote for AAPL"