get_account_info_toolLABSCO SUMMARY
A paper trading account an assistant can actually operate.
All four order types are here, which means a full entry and exit can be expressed rather than just a buy: a stop-limit is the same kind of call as a market order. The documented configuration points at paper trading, so a strategy can be exercised end to end before real money is involved.
What it is
A trading connection to the Alpaca API covering stocks and crypto. Account and portfolio state, the four order types, and position management are tools; quotes, positions and recent orders are also exposed as resources.
What you get
- Account details and balances, and a portfolio summary with its performance
- Market and limit orders
- Stop and stop-limit orders, for exits defined in advance
- An order cancelled before it fills
- A position closed on request
- Resources alongside the tools: account info, all positions, one symbol's position, and recent orders
Requirements
Alpaca API credentials in a local .env file — the documented setup uses paper trading keys, which you create from an Alpaca account.
Setup effort
Build from source
USE CASES
01
Checking where the portfolio stands
Read the account details and the portfolio summary together, so buying power and current performance come back in one answer.
02
Taking a position now
Place a market order when the fill matters more than the price, or a limit order when it is the other way round.
03
Setting an exit before you need it
Place a stop or stop-limit order so the exit is defined while you are calm rather than decided while the position is moving.
04
Getting out of a position
Close the position outright, and check the account afterwards to confirm what the exit did to the balance.
05
Pulling an order that no longer makes sense
Cancel a resting order when the reason for it has gone, instead of leaving it to fill on a move you no longer want.
8 tools
Listed in project docs. Your client may show a different list.
place_market_orderplace_limit_orderplace_stop_orderplace_stop_limit_ordercancel_orderclose_positionget_portfolio_summaryBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- Python with pip, or uv, to install it from the clone
- uv on PATH — the Claude Desktop configuration runs uv
- ALPACA_PAPER_API_KEY in your environment
- ALPACA_PAPER_API_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/laukikk/alpaca-mcp
cd alpaca-mcp
pip install -e .
cp .env.example .envMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"alpaca": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_ALPACA_MCP>",
"run",
"src/server.py"
]
}
}
}<YOUR_PATH_TO_ALPACA_MCP> is the full path of the alpaca-mcp folder the git clone step creates (the README's example calls it alpaca-mcp-server). The server reads ALPACA_PAPER_API_KEY and ALPACA_PAPER_API_SECRET from the .env file in that folder.
The configuration on this page does not set ALPACA_PAPER_API_KEY and ALPACA_PAPER_API_SECRET; the project's instructions put them in a .env file. Check which folder the server reads that file from before you rely on it.
