Alpaca MCP Server v2 is here. This version is a complete rewrite built with FastMCP and OpenAPI. If you're upgrading from v1, please read the Upgrade Guide — tool names, parameters, and…
alpaca-mcp-server is an MCP project maintained in the alpacahq/alpaca-mcp-server repository. The maintainer describes its purpose as “Alpaca MCP Server v2 is here. This version is a complete rewrite built with FastMCP and OpenAPI. If you're upgrading from v1, please read the…”. Read the project documentation for the complete scope.
The documented pypi package is alpaca-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares ALPACA_API_KEY, ALPACA_SECRET_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| get_account_info | Balance, margin, and account status |
| get_account_config | Trading restrictions, margin settings, PDT checks |
| update_account_config | Update account configuration settings |
| get_portfolio_history | Equity and P/L over time |
| get_account_activities | Fills, dividends, transfers |
| get_account_activities_by_type | Activities filtered by type |
| get_orders | Retrieve orders with filters |
| get_order_by_id | Single order by ID |
| get_order_by_client_id | Single order by client order ID |
| replace_order_by_id | Replace an existing open order |
| cancel_order_by_id | Cancel a specific order |
| cancel_all_orders | Cancel all open orders |
| place_stock_order | Stocks/ETFs (market, limit, stop, stop-limit, trailing-stop, brackets) |
| place_crypto_order | Crypto (market, limit, stop-limit) |
| place_option_order | Options (single-leg or multi-leg) |
| get_all_positions | All current positions |
| get_open_position | Details for a specific position |
| close_position | Close a specific position |
| close_all_positions | Liquidate entire portfolio |
| exercise_options_position | Exercise a held option contract |
| do_not_exercise_options_position | Do-not-exercise instruction |
| create_watchlist | Create a new watchlist |
| get_watchlists | List all watchlists |
| get_watchlist_by_id | Get a specific watchlist |
| update_watchlist_by_id | Update a watchlist |
| delete_watchlist_by_id | Delete a watchlist |
| add_asset_to_watchlist_by_id | Add an asset to a watchlist |
| remove_asset_from_watchlist_by_id | Remove an asset from a watchlist |
| get_all_assets | List assets with optional filtering |
| get_asset | Detailed info for a specific asset |
| get_option_contracts | Option contracts for underlying symbol(s) |
| get_option_contract | Single option contract by symbol or ID |
| get_calendar | Market calendar for a date range |
| get_clock | Current market status and next open/close |
| get_corporate_action_announcements | Corporate action announcements |
| get_corporate_action_announcement | Single announcement by ID |
| get_stock_bars | Historical OHLCV bars |
| get_stock_quotes | Historical bid/ask quotes |
| get_stock_trades | Historical trades |
| get_stock_latest_bar | Latest minute bar |
| get_stock_latest_quote | Latest quote |
| get_stock_latest_trade | Latest trade |
| get_stock_snapshot | Comprehensive snapshot |
| get_most_active_stocks | Most active by volume/trade count |
| get_market_movers | Top gainers and losers |
| get_crypto_bars | Historical OHLCV bars |
| get_crypto_quotes | Historical quotes |
| get_crypto_trades | Historical trades |
| get_crypto_latest_bar | Latest minute bar |
| get_crypto_latest_quote | Latest quote |
| get_crypto_latest_trade | Latest trade |
| get_crypto_snapshot | Comprehensive snapshot |
| get_crypto_latest_orderbook | Latest orderbook |
| get_option_bars | Historical OHLCV bars |
| get_option_trades | Historical trades |
| get_option_latest_trade | Latest trade |
| get_option_latest_quote | Latest quote with bid/ask and exchange info |
| get_option_snapshot | Snapshot with Greeks and IV |
| get_option_chain | Full option chain for an underlying |
| get_option_exchange_codes | Exchange code to name mapping |
| get_corporate_actions | Corporate action announcements from market data |
| get_news | News articles for stocks and crypto |
| get_fixed_income_latest_quotes | Latest quotes for fixed income securities by ISIN |
| get_locates | List locate requests filtered by status, symbol, or date range |
| create_locate | Create a locate request for a short sale |
| get_locate | Get a single locate request by ID |
| get_locate_quotes | Get locate availability and pricing for symbols |
| search_alpaca_docs | Search Alpaca documentation pages and guides |
| fetch_alpaca_doc | Fetch one Alpaca ReadMe documentation page by page ID |
| search_alpaca_api_specs | Search Alpaca API reference endpoints by topic, path, parameter, or schema term |
| list_alpaca_api_endpoints | List endpoints for one allowed Alpaca OpenAPI spec |
| get_alpaca_endpoint_docs | Fetch reference docs for one exact Alpaca API endpoint by method and path |
{
"mcpServers": {
"alpaca": {
"command": "uvx",
"args": [
"alpaca-mcp-server"
],
"env": {
"ALPACA_API_KEY": "YOUR_ALPACA_API_KEY",
"ALPACA_SECRET_KEY": "YOUR_ALPACA_SECRET_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| ALPACA_API_KEY | Declared in the maintainer’s client configuration. | Yes |
| ALPACA_SECRET_KEY | Declared in the maintainer’s client configuration. | Yes |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.