# alpaca-mcp-server-trading

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 185 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/alpaca-mcp-server-trading/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alpaca-mcp-server-trading

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/alpaca-mcp-server-trading/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/alpaca-mcp-server-trading/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/alpaca-mcp-server-trading/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/alpaca-mcp-server-trading/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/alpaca-mcp-server-trading
```

2. **Manually: put the files in place**
- File: `.github/skills/alpaca-mcp-server-trading/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/alpaca-mcp-server-trading
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/alpaca-mcp-server-trading/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-mcp-server-trading -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/alpaca-mcp-server-trading/SKILL.md

## When to use it
- 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
- 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

## Similar
- [Canli Paper Trading](https://affpapa.org/en/nevibecode/mcp/canli-paper-trading.md) — MCP server · ★ 6 repo stars
- [portfolio-manager](https://affpapa.org/en/nevibecode/skills/portfolio-manager.md) — skill · 4200 installs
- [parabolic-short-trade-planner](https://affpapa.org/en/nevibecode/skills/parabolic-short-trade-planner.md) — skill · 3300 installs
- [backtesting-trading-strategies](https://affpapa.org/en/nevibecode/skills/backtesting-trading-strategies.md) — skill · 4800 installs
- [trading-plan-generator](https://affpapa.org/en/nevibecode/skills/trading-plan-generator.md) — skill · 1100 installs
- [trading-wisdom](https://affpapa.org/en/nevibecode/skills/trading-wisdom.md) — skill · 808 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
