Alpaca MCP Server
Alpaca MCP Server is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in… It has 1,044 GitHub stars, is released under the MIT license and runs locally with uvx alpaca-mcp-server.
github.com/alpacahq/alpaca-mcp-server (opens in a new tab)
Data as of from the GitHub API; description from the project's repository. Report an error
Install Alpaca MCP Server
Generated from the server's published package. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server"
],
"env": {
"ALPACA_API_KEY": "your-value",
"ALPACA_SECRET_KEY": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env ALPACA_API_KEY=your-value --env ALPACA_SECRET_KEY=your-value --transport stdio alpaca-mcp-server -- uvx alpaca-mcp-serverCursor
{
"mcpServers": {
"alpaca-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"alpaca-mcp-server"
],
"env": {
"ALPACA_API_KEY": "your-value",
"ALPACA_SECRET_KEY": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "alpaca_api_key",
"description": "ALPACA_API_KEY",
"password": true
},
{
"type": "promptString",
"id": "alpaca_secret_key",
"description": "ALPACA_SECRET_KEY",
"password": true
}
],
"servers": {
"alpaca-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"alpaca-mcp-server"
],
"env": {
"ALPACA_API_KEY": "${input:alpaca_api_key}",
"ALPACA_SECRET_KEY": "${input:alpaca_secret_key}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
ALPACA_API_KEYsecret | No | Shown in the README's example configuration. |
ALPACA_SECRET_KEYsecret | No | Shown in the README's example configuration. |
ALPACA_PAPER_TRADE | No | Shown in the README's example configuration. |
ALPACA_TOOLSETS | No | Shown in the README's example configuration. |
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
get_account_infoBalance, margin, and account status
get_account_configTrading restrictions, margin settings, PDT checks
update_account_configUpdate account configuration settings
get_portfolio_historyEquity and P/L over time
get_account_activitiesFills, dividends, transfers
get_account_activities_by_typeActivities filtered by type
get_ordersRetrieve orders with filters
get_order_by_idSingle order by ID
get_order_by_client_idSingle order by client order ID
replace_order_by_idReplace an existing open order
cancel_order_by_idCancel a specific order
cancel_all_ordersCancel all open orders
place_stock_orderStocks/ETFs (market, limit, stop, stop-limit, trailing-stop, brackets)
place_crypto_orderCrypto (market, limit, stop-limit)
place_option_orderOptions (single-leg or multi-leg)
get_all_positionsAll current positions
get_open_positionDetails for a specific position
close_positionClose a specific position
close_all_positionsLiquidate entire portfolio
exercise_options_positionExercise a held option contract
do_not_exercise_options_positionDo-not-exercise instruction
create_watchlistCreate a new watchlist
get_watchlistsList all watchlists
get_watchlist_by_idGet a specific watchlist
update_watchlist_by_idUpdate a watchlist
delete_watchlist_by_idDelete a watchlist
add_asset_to_watchlist_by_idAdd an asset to a watchlist
remove_asset_from_watchlist_by_idRemove an asset from a watchlist
get_all_assetsList assets with optional filtering
get_assetDetailed info for a specific asset
get_option_contractsOption contracts for underlying symbol(s)
get_option_contractSingle option contract by symbol or ID
get_calendarMarket calendar for a date range
get_clockCurrent market status and next open/close
get_corporate_action_announcementsCorporate action announcements
get_corporate_action_announcementSingle announcement by ID
get_stock_barsHistorical OHLCV bars
get_stock_quotesHistorical bid/ask quotes
get_stock_tradesHistorical trades
get_stock_latest_barLatest minute bar
About Alpaca MCP Server
A comprehensive Model Context Protocol (MCP) server for Alpaca's Trading API. Enable natural language trading operations through AI assistants like Claude, Cursor, and VS Code. Supports stocks, options, crypto, portfolio management, and real-time market data.
- ai-trading
- algorithmic-trading
- mcp
- mcp-server
- options
- stocks
- trading
- trading-api
- crypto
- etfs
Similar MCP servers
More finance MCP servers
Tradememory Protocol
mnemox-ai/tradememory-protocol
Tamper-evident decision audit trail and outcome-weighted memory for AI trading agents.
Active · last commit Oct 9, 2026
FinancePythonTickDB Market Data
TickDB/tickdb-unified-realtime-marketdata-api
Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes.
Active · last commit Oct 14, 2026
FinancePythonAI
stripe/ai
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Maintained · last commit Oct 26, 2026
OfficialFinanceTypeScriptCNEquity
rootSunc/CNEquity
China A-share data lake for AI agents: prices, fundamentals, flows and events, point-in-time.
Active · last commit Oct 25, 2026
FinancePythonEdgarTools
dgunning/edgartools
Open-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type.
Active · last commit Oct 25, 2026
FinancePythonAttestix
VibeTensor/attestix
AI agent identity, signed credentials, delegated authority and governance evidence.
Active · last commit Oct 12, 2026
OfficialFinancePython
How do I install the Alpaca MCP Server MCP server?
Add the command uvx alpaca-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Alpaca MCP Server free?
The server is open source under the MIT license, so running it is free. It needs credentials (ALPACA_API_KEY and ALPACA_SECRET_KEY) for the service it connects to, which may require a paid account.
Is Alpaca MCP Server actively maintained?
The most recent commit was on Oct 23, 2026. The latest release is v2.4.0, published Oct 12, 2026. appsgit only lists MCP servers with a commit in the last six months.