# alpaca-trading-mcp-server

Connects AI coding assistants to Alpaca Trading API for equities, crypto, and options orders using natural language instructions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 186 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-trading-mcp-server/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-trading-mcp-server

## What it does

This skill connects your coding environment to Alpaca's official MCP server. It enables the assistant to pull live market feeds, inspect order books, submit trades, and check balances. Supported asset classes include equities, ETFs, crypto pairs, and options. If you want to limit active endpoints, define `ALPACA_TOOLSETS` in the configuration to restrict tools to subsets such as `account`, `trading`, or `news`.

The setup requires Python 3.10 or newer, the `uv` tool, and registered Alpaca API keys. Because `ALPACA_PAPER_TRADE` defaults to `true`, initial prompts run against a virtual simulator without risking real money. You can run the server directly via `uvx alpaca-mcp-server` or package it into a Docker container.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/alpaca-trading-mcp-server/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-trading-mcp-server
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill alpaca-trading-mcp-server -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-trading-mcp-server/SKILL.md

## When to use it
- place limit and market orders directly from agent conversation
- fetch historical candle data, quotes, and crypto order books
- filter option chains by expiration date and calculate Greeks
- track account balance, buying power, and active positions

## Example prompts
- Buy 10 shares of AAPL at market price
- Show me the order book for BTC/USD and current buying power

## Similar
- [trading-risk-manager](https://affpapa.org/en/nevibecode/agents/trading-risk-manager.md) — subagent · 82 installs
- [backtesting-trading-strategies](https://affpapa.org/en/nevibecode/skills/backtesting-trading-strategies.md) — skill · 4800 installs
- [report-stock](https://affpapa.org/en/nevibecode/skills/report-stock.md) — skill · 123 installs
- [Canli Paper Trading](https://affpapa.org/en/nevibecode/mcp/canli-paper-trading.md) — MCP server · ★ 6 repo stars
- [trading-strategist](https://affpapa.org/en/nevibecode/skills/trading-strategist.md) — skill · 1100 installs
- [portfolio-manager](https://affpapa.org/en/nevibecode/skills/portfolio-manager.md) — skill · 4200 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
