Alpaca Trading MCP Server

1# Alpaca Trading MCP Server
2 
3[![smithery badge](https://smithery.ai/badge/@laukikk/alpaca-mcp)](https://smithery.ai/server/@laukikk/alpaca-mcp)
4 
5A Model Context Protocol (MCP) server that provides an interface to the Alpaca trading API, allowing you to manage your stock and crypto portfolio, place trades, and access market data.
6 
7## Features
8 
9- **Account Management**: View account details, balances, and portfolio status
10- **Trading**: Place market, limit, stop, and stop-limit orders
11- **Portfolio Management**: View positions, calculate performance, and close positions
12- **Market Data**: Access real-time quotes and historical price data
13- **Asset Information**: Get details about tradable assets
14 
15## Installation
16 
17### Installing via Smithery
18 
19To install Alpaca Trading MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@laukikk/alpaca-mcp):
20 
21```bash
22npx -y @smithery/cli install @laukikk/alpaca-mcp --client claude
23```
24 
25### Manual Installation
261. Clone this repository
272. Install dependencies:
28 
29```bash
30pip install -e .
31```
32 
33Or using uv:
34 
35```bash
36uv pip install -e .
37```
38 
39## Configuration
40 
411. Copy the `.env.example` file to `.env`:
42 
43```bash
44cp .env.example .env
45```
46 
472. Add your Alpaca Paper Trading API credentials to the `.env` file:
48 
49```
50ALPACA_PAPER_API_KEY = "your-api-key"
51ALPACA_PAPER_API_SECRET = "your-api-secret"
52```
53 
54You can obtain these credentials by creating an account at [Alpaca](https://app.alpaca.markets/signup).
55 
56## Usage
57 
58Run the MCP server:
59 
60```bash
61python src/server.py
62```
63 
64The server will start and be available for MCP clients to connect to.
65 
66## Testing with Claude for Desktop
67 
68### Configuration:
69 
70Open your Claude for Desktop App configuration in a text editor. Create the file if it doesn't exist.
71 
72- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
73- Mac: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
74 
75 
76Add the Alpaca MCP server configuration:
77 
78```json
79{
80    "mcpServers": {
81        "alpaca": {
82            "command": "uv",
83            "args": [
84                "--directory",
85                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
86                "run",
87                "src/server.py"
88            ]
89        }
90    }
91}
92```
93[MCP For Server Developers: Quickstart](https://modelcontextprotocol.io/quickstart/server)
94 
95## Available Resources
96 
97The server provides the following resources:
98 
99- `account://info` - Get current account information
100- `positions://all` - Get all current positions
101- `positions://{symbol}` - Get position details for a specific symbol
102- `orders://recent/{limit}` - Get most recent orders with specified limit
103- `market://{symbol}/quote` - Get current market quote for a specific symbol
104- `market://{symbol}/bars/{timeframe}` - Get historical price bars for a symbol with specified timeframe
105- `assets://list` - List tradable assets available on Alpaca
106- `assets://{symbol}` - Get detailed asset information by symbol
107 
108## Available Tools
109 
110The server provides the following tools:
111 
112- `get_account_info_tool` - Get current account information
113- `place_market_order` - Place a market order to buy or sell a stock
114- `place_limit_order` - Place a limit order to buy or sell a stock at a specified price
115- `place_stop_order` - Place a stop order to buy or sell a stock when it reaches a specified price
116- `place_stop_limit_order` - Place a stop-limit order combining stop and limit order features
117- `cancel_order` - Cancel an open order by its ID
118- `close_position` - Close an open position for a specific symbol
119- `get_portfolio_summary` - Get a comprehensive summary of the portfolio
120