alpaca-mcp-server-trading — Claude Code skill: setup and features
alpaca-mcp-server-trading connects the Alpaca MCP server to your AI coding agent to execute trades, check account balances, and fetch live market quotes in natural language.
no license 185 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a claude-codeWhat alpaca-mcp-server-trading does
This skill guides your AI assistant on configuring and interacting with the Alpaca MCP server. It connects to Alpaca's Trading API using FastMCP. Through standard chat prompts, the assistant can submit market, limit, or stop orders, track portfolio performance, and inspect ticker snapshots across stocks, ETFs, crypto, and options.
Running the server requires Python 3.10+, the uv tool, and Alpaca API credentials. The server starts in paper trading mode by default. Real money trading requires switching ALPACA_PAPER_TRADE to false and providing live credentials, so test order logic thoroughly on simulated funds first.
You can also narrow agent permissions. Setting ALPACA_TOOLSETS limits exposed tools to specific groups, such as stock data and portfolio inspection, preventing unintended trades.
What it helps with
- fetch real-time stock quotes and bar history in chat
- place equity and crypto orders using plain text prompts
- retrieve account buying power and active portfolio positions
- restrict Alpaca tool access with custom toolset filters
Example prompts for the agent
- Check my Alpaca account balance and buying power
- Place a limit order to buy 5 shares of TSLA at $250
- Show daily price bars and a snapshot for NVDA
How to install alpaca-mcp-server-trading
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a claude-code2Manually: put the files in place
~/.claude/skills/alpaca-mcp-server-trading/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/alpaca-mcp-server-trading/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a codex2Manually: put the files in place
.agents/skills/alpaca-mcp-server-trading/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a cursor2Manually: put the files in place
.cursor/skills/alpaca-mcp-server-trading/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/alpaca-mcp-server-trading2Manually: put the files in place
.github/skills/alpaca-mcp-server-trading/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/alpaca-mcp-server-tradingManually: put the files in place
.devin/skills/alpaca-mcp-server-trading/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about alpaca-mcp-server-trading
How do I install alpaca-mcp-server-trading in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a claude-code in your terminal. Next, add your Alpaca credentials to your MCP client configuration file.
What does alpaca-mcp-server-trading do?
It provides operational instructions for connecting the Alpaca MCP server to AI assistants. It enables conversational order execution, account auditing, and market research across equities and digital assets.
Does the server trade real funds immediately?
No. The server defaults to paper trading via ALPACA_PAPER_TRADE=true. To place live trades with real capital, you must explicitly set that variable to false and insert live account keys.