Alpaca MCP Server
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Enables secure storage and loading of Alpaca API credentials through environment variables stored in a .env file.
Required for cloning the repository during the installation process.
The repository hosting the MCP server code that users need to clone for installation.
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
- Clone this repository:Copy
- Install the required packages:Copy
- Create a
.env
file with your Alpaca API credentials:Copy
Usage
Running the server
Start the server by running:
Configuring Claude for Desktop
- Open Claude for Desktop
- Go to Settings
- Click on "Developer" and then "Edit Config"
- Add the server configuration to
claude_desktop_config.json
:
- Save and restart Claude for Desktop
Available Tools
The server exposes the following tools:
get_account_info()
- Get account balances and statusget_positions()
- List all current positions in the portfolioget_stock_quote(symbol)
- Get the latest quote for a stockget_stock_bars(symbol, days)
- Get historical price bars for a stockget_orders(status, limit)
- List orders with specified statusplace_market_order(symbol, side, quantity)
- Place a market orderplace_limit_order(symbol, side, quantity, limit_price)
- Place a limit ordercancel_all_orders()
- Cancel all open ordersclose_all_positions(cancel_orders)
- 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"
- "Show me the price history for TSLA over the last 10 days"
- "Buy 5 shares of MSFT at market price"
- "Sell 10 shares of AMZN with a limit price of $130"
- "Cancel all my open orders"
Note
This server uses Alpaca's paper trading by default. To use real money trading, change paper=True
to paper=False
in the TradingClient
initialization.
Security Notice
This MCP server will have access to your Alpaca account and can place real trades. Always review what Claude is suggesting before approving any trades.
License
MIT
This server cannot be installed
A Model Context Protocol server enabling LLMs like Claude to interact with the Alpaca trading API through natural language for stock trading, checking positions, fetching market data, and managing your account.