# Alpaca — how to use (mcp.ai)

Connect your Alpaca account and use 100 tools for commerce straight from your AI agent. Connect with your own API key. Stock and crypto trading platform with commission-free trading, real-time market data, and algorithmic trading capabilities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_alpaca?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `alpaca_add_asset_to_watchlist`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/alpaca`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/alpaca/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/alpaca/add/asset/to/watchlist` — Adds a symbol to an existing watchlist in the authenticated account. Use when you need to track a new security in an existing watchlist. This action appends the specified symbol to the end of the watc
  - body: { symbol: string, watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/add/asset/to/watchlist/by/name` — Add an asset to a watchlist by name. Use when you need to add a symbol to a specific watchlist identified by its name. If a watchlist with the specified name does not exist, it will be created automat
  - body: { name: string, symbol: string }
- `POST https://api.mcp.ai/api/alpaca/create/watchlist` — Creates a new watchlist for the authenticated account. Use this action when you need to: - Create a new watchlist to track specific securities - Set up initial symbols for a watchlist at creation time
  - body: { name: string, symbols?: string[] }
- `POST https://api.mcp.ai/api/alpaca/create/watchlist/for/account` — Create a new watchlist for the authenticated account. Use when you need to create a watchlist to track specific securities. The name must contain only alphanumeric characters (no spaces or special cha
  - body: { name: string, symbols: string[], account_id: string }
- `POST https://api.mcp.ai/api/alpaca/delete/all/open/positions` — Liquidates all open positions by closing them at market price. This action is irreversible and will permanently close all positions in the account. Use when you need to quickly exit all positions, suc
  - body: { cancel_orders?: boolean }
- `POST https://api.mcp.ai/api/alpaca/delete/all/orders/for/account` — Attempts to cancel all open orders for a specified trading account. A response will be provided for each order that is attempted to be cancelled. This action is irreversible for individual orders that
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/alpaca/delete/unsubscribe/account` — Delete a rebalancing subscription to unsubscribe an account. This action permanently removes the specified subscription. Use when you need to unsubscribe an account from rebalancing services. This act
  - body: { subscription_id: string }
- `POST https://api.mcp.ai/api/alpaca/delete/watchlist/by/id` — Delete a watchlist by its unique identifier. Use when you need to remove an entire watchlist that is no longer needed. This action is irreversible once executed — the watchlist and all its contents ca
  - body: { watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/account` — Retrieves account information for the authenticated Alpaca account. Use this action when you need to check account status, available buying power, cash balance, equity, margin information, day trade c
- `POST https://api.mcp.ai/api/alpaca/get/account/activities` — Retrieves account activities for the authenticated Alpaca account. Use this action when you need to retrieve transaction history, dividend payments, interest payments, fees, transfers, or other accoun
  - body: { date?: string, after?: string, until?: string, direction?: string, page_size?: integer, account_id?: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/account/activities/by/activity/type` — Retrieves account activities of a specific type for the authenticated Alpaca account. Use when you need to filter account activities by a specific type such as trade fills, dividends, interest payment
  - body: { date?: string, after?: string, until?: string, direction?: string, page_size?: integer, page_token?: string, activity_type: string }
- `POST https://api.mcp.ai/api/alpaca/get/account/activities2` — Retrieves account activities of one type for the authenticated Alpaca account using the v2 API. Use this action when you need to retrieve transaction history, dividend payments, interest payments, fee
  - body: { date?: string, after?: string, until?: string, direction?: string, page_size?: integer, page_token?: string, activity_types?: string }
- `POST https://api.mcp.ai/api/alpaca/get/account/config` — Retrieves the current trading account configuration settings for the authenticated Alpaca account. Use this action when you need to check the current trading account settings such as day-trading margi
- `POST https://api.mcp.ai/api/alpaca/get/account/portfolio/history` — Retrieves the portfolio history statistics for an Alpaca trading account. Portfolio history provides a time series of equity values, profit/loss metrics, and other performance data over a specified ti
  - body: { period?: string, date_end?: string, timeframe?: string, extended_hours?: boolean }
- `POST https://api.mcp.ai/api/alpaca/get/account/portfolio/history1` — Retrieves the portfolio history statistics for a trading account. Portfolio history provides a time series of equity values, profit/loss metrics, and optionally cashflow data over a specified time per
  - body: { end?: string, start?: string, period?: string, date_end?: string, pnl_reset?: string, timeframe?: string, account_id?: string, extended_hours?: boolean }
- `POST https://api.mcp.ai/api/alpaca/get/accounts/positions` — Bulk fetches all open positions for the authenticated account. Use when you need to retrieve all current positions, monitor overall portfolio holdings, or check unrealized P&L across the entire accoun
- `POST https://api.mcp.ai/api/alpaca/get/all/open/positions` — Retrieves all open positions for the authenticated Alpaca trading account. Use this action when you need to retrieve all current positions, monitor portfolio holdings, or check unrealized P&L across t
- `POST https://api.mcp.ai/api/alpaca/get/all/orders` — Retrieves all orders for an account based on specified filter criteria. Returns a list of orders with their current status, filled quantity, prices, and any nested legs for complex orders. Use when yo
  - body: { after?: string, limit?: integer, until?: string, nested?: boolean, status?: string, symbols?: string, direction?: string }
- `POST https://api.mcp.ai/api/alpaca/get/alpaca/data/crypto/us/bars` — Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for crypto symbols in a specific US location. Use this action when you need to analyze historical price movements and trading activity 
  - body: { end?: string, loc: string, sort?: string, limit?: integer, start?: string, symbols: string, timeframe: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/bars/for/multiple/crypto/symbols` — Retrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols. Use this action when you need to: - Get historical price data for multiple crypto symbols - Analyze price trends over
  - body: { end?: string, limit?: integer, start?: string, symbols: string, exchanges?: string, timeframe: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/bars/for/multiple/stock/symbols` — Retrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols. Use this action when you need to: - Get historical price data for multiple stock symbols - Analyze price trends over a
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbols: string, timeframe: string, adjustment?: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/bars/for/stock/symbol` — Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol. Use this action when you need to analyze historical price movements and trading activity for a specific stoc
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbol: string, timeframe: string, adjustment?: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/bars/stocks` — Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol. Use this action when you need to analyze historical price movements and trading activity for a specific stoc
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbol: string, timeframe: string, adjustment?: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/calendar` — Retrieves market calendar information for trading days from the Alpaca Trading API. Use this action when you need to: - Get market open and close times for specific dates - Check trading session times
  - body: { end?: string, start?: string }
- `POST https://api.mcp.ai/api/alpaca/get/clock` — Retrieves the current market clock information from the Alpaca Trading API. Use this action when you need to: - Check if the market is currently open - Determine when the next market open or close wil
- `POST https://api.mcp.ai/api/alpaca/get/conditions` — Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified type (trade or quote conditions) and tape. Use this action when you need to: - Decode condition codes 
  - body: { tape: string, type: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/latest/quotes` — Retrieves the latest bid and ask prices for specified crypto symbols at a specific location. Use when you need real-time quote data for cryptocurrency trading, such as checking current market prices b
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perp/latest/bars` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols. Use this action when you need real-time or near real-time price data for crypto perpetual futures
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perp/latest/order/books` — Retrieves the latest bid and ask orderbook data for specified crypto perpetual futures symbols. Use when you need real-time orderbook data for crypto perpetual futures trading, such as checking curren
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perp/latest/pricing` — Retrieves the latest pricing data for specified crypto perpetual futures symbols. Use when you need real-time pricing data for crypto perpetual futures trading, such as checking current market prices,
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perp/latest/quotes` — Retrieves the latest bid and ask prices for specified crypto perpetual futures symbols for a specific location. Use when you need real-time quote data for crypto perpetual futures trading, such as che
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perp/latest/trades` — Retrieves the latest trade data for specified crypto perpetual futures symbols. Use when you need real-time trade data for crypto perpetual futures trading, such as monitoring recent trades, analyzing
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perps/global/latest/bars` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols. Use this action when you need real-time or near real-time price data for crypto perpetual futures
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perps/global/latest/pricing` — Returns the latest pricing data for crypto perpetual futures symbols. Use this action when you need to retrieve current market data for crypto perpetual futures contracts including mark price, index p
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perps/global/latest/quotes` — Retrieves the latest bid and ask prices for specified crypto perpetual futures symbols. Use when you need real-time quote data for crypto perpetual futures trading, such as checking current market pri
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/perps/global/latest/trades` — Retrieves the latest trade data for specified crypto perpetual futures symbols. Use when you need real-time trade data for crypto perpetual futures trading, such as monitoring recent trades, analyzing
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/snapshots` — Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in a specific location. Use this action when you need comprehensive 
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/latest/bars` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for US crypto symbols. Use this action when you need real-time or near real-time price data for multiple crypto trading pairs. Returns 
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/latest/order/books` — Retrieves the latest bid and ask orderbook data for specified crypto symbols in the US market. Use when you need real-time orderbook data for cryptocurrency trading in the US market, such as checking 
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/latest/quotes` — Retrieves the latest bid and ask prices for specified crypto symbols in the US location. Use when you need real-time quote data for cryptocurrency trading in the US market, such as checking current ma
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/latest/trades` — Retrieves the latest trade data for specified crypto symbols in the US location. Use when you need real-time trade data for cryptocurrency trading, such as monitoring recent trades, analyzing price mo
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/quotes` — Retrieves historical quote data (bid/ask prices) for specified crypto symbols on US exchanges. Returns quotes sorted by symbol first, then by timestamp. Use when you need: - Historical bid/ask price d
  - body: { end?: string, sort?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/snapshots` — Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in the US market location. Use this action when you need comprehensi
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/crypto/us/trades` — Retrieves historical trade data for specified US crypto symbols. Use when you need to: - Get historical trade data for US crypto symbols at once - Analyze trading volume and price movements over time 
  - body: { end?: string, sort?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/exchanges` — Retrieves a list of supported stock exchanges with their short codes and full names from the Alpaca Market Data API. Use this action when you need to: - Get the mapping between exchange codes and full
- `POST https://api.mcp.ai/api/alpaca/get/latest/bar/for/stock/symbol` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bar for a single stock symbol. Use this action when you need real-time or near real-time price bar data for a specific stock trading symbol.
  - body: { feed?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/bars/for/crypto/symbol` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bar data for a crypto symbol. Use this action when you need real-time or near real-time price data for a specific cryptocurrency pair. Retur
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/bars/for/crypto/symbols` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols. Use this action when you need real-time or near real-time price bar data for multiple cryptocurrency pairs
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/bars/for/multiple/stock/symbols` — Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols. Use this action when you need real-time or near real-time price bar data for multiple stock trading symbols
  - body: { feed?: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/order/books/for/crypto` — Retrieves the latest bid and ask orderbook data for specified crypto symbols. Use when you need real-time orderbook data for cryptocurrency trading, such as checking current market depth before placin
  - body: { loc: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/quote/for/crypto/symbol` — Retrieves the latest bid and ask prices for a specified crypto symbol. Use when you need real-time quote data for a specific cryptocurrency, such as checking current market prices before placing an or
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/quote/for/stock/symbol` — Retrieves the latest NBBO (National Best Bid and Offer) quote for a single stock symbol. Use this action when you need real-time or near real-time bid and ask prices for a specific stock trading symbo
  - body: { feed?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/quotes/for/multiple/crypto/symbols` — Retrieves the latest bid and ask prices for specified crypto symbols. Use when you need real-time quote data for cryptocurrency trading, such as checking current market prices before placing orders or
  - body: { symbols: string, exchange?: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/quotes/for/multiple/stock/symbols` — Retrieves the latest NBBO (National Best Bid and Offer) quotes for multiple stock symbols. Use this action when you need real-time or near real-time bid and ask prices for multiple stock trading symbo
  - body: { feed?: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/trade/for/stock/symbol` — Retrieves the latest trade data for a single stock symbol. Use this action when you need the most recent trade information for a specific stock ticker, such as checking current market price and volume
  - body: { feed?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/trades/for/multiple/crypto/symbols` — Retrieves the latest trade data for specified crypto symbols. Use when you need real-time trade data for cryptocurrency trading, such as monitoring recent trades, analyzing price movements, or trackin
  - body: { symbols: string, exchange: string }
- `POST https://api.mcp.ai/api/alpaca/get/latest/trades/for/multiple/stock/symbols` — Retrieves the latest trade data for multiple stock symbols. Use this action when you need real-time or near real-time trade data for multiple stock trading symbols simultaneously. This is useful for d
  - body: { feed?: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/market/calendar` — Retrieves market calendar information for a specific exchange from the Alpaca Trading API. Use this action when you need to: - Get market open and close times for a specific exchange (NYSE, NASDAQ, et
  - body: { end?: string, start?: string, market: string }
- `POST https://api.mcp.ai/api/alpaca/get/meta/exchanges` — Retrieves a list of all US stock exchanges and their identifying information from the Alpaca Market Data API. Use this action when you need to: - Get details about available stock exchanges for order 
- `POST https://api.mcp.ai/api/alpaca/get/most/actives` — Retrieves the most active stocks by trading volume or trade count. Use this action when you need to: - Fetch top traded stocks for the current period - Monitor market liquidity and activity - Build tr
  - body: { by?: string, top?: integer }
- `POST https://api.mcp.ai/api/alpaca/get/news` — Retrieves news articles for specified crypto symbols from the Alpaca Market Data API. Use this action when you need to: - Fetch the latest news for crypto assets (BTCUSD, ETHUSD, etc.) - Monitor news 
  - body: { end?: string, sort?: string, limit?: integer, start?: string, symbols: string, page_token?: string, include_content?: boolean, exclude_contentless?: boolean }
- `POST https://api.mcp.ai/api/alpaca/get/open/position` — Fetches a single open position by symbol or asset ID. Use when you need to retrieve detailed information about a specific position, including cost basis, shares traded, market value, and unrealized P&
  - body: { symbol_or_asset_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/bars` — Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for options contracts. Use this action when you need to analyze historical price movements and trading activity for specific option con
  - body: { end?: string, sort?: string, limit?: integer, start?: string, symbols: string, timeframe: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/chain` — Retrieves the option chain for a specific underlying symbol including quotes and greeks for all available strikes and expirations. Use this action when you need comprehensive option market data for a 
  - body: { feed?: string, type?: string, expiration_date?: string, strike_price_gte?: number, strike_price_lte?: number, underlying_symbol: string, expiration_date_gte?: string, expiration_date_lte?: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/contract/symbol/or/id` — Get an option contract by its symbol or unique identifier. Use this action when you need to retrieve detailed information about a specific option contract. You can query by either the contract's OCC s
  - body: { symbol_or_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/latest/quotes` — Retrieves the latest bid and ask prices for specified option symbols. Use when you need real-time quote data for options trading, such as checking current market prices before placing orders or monito
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/meta/conditions` — Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified tick type (trade or quote conditions). Use this action when you need to: - Decode condition codes from
  - body: { ticktype: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/snapshots` — Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple option contract symbols. Use this action when you need comprehensive real-time market data 
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/option/trades` — Retrieves historical trade data for option contracts. Use this action when you need to: - Analyze historical trade activity for option contracts - Review past trades for specific option symbols - Calc
  - body: { end?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/options/contracts` — Retrieve option contracts from Alpaca Markets API (BETA). Use this action when you need to: - Search for option contracts by underlying symbol - Filter contracts by expiration date, strike price, type
  - body: { type?: string, limit?: integer, ppind?: boolean, style?: string, status?: string, page_token?: string, root_symbol?: string, expiration_date?: string, strike_price_gte?: number, strike_price_lte?: number, show_deliverables?: boolean, underlying_symbols?: string, expiration_date_gte?: string, expiration_date_lte?: string }
- `POST https://api.mcp.ai/api/alpaca/get/options/latest/trades` — Retrieves the latest trade for each requested option contract symbol. Use this action when you need to: - Get the most recent trade price and size for specific option contracts - Check the last traded
  - body: { symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/options/meta/conditions/trade` — Retrieves the mapping of trade condition codes to their names from Alpaca Markets API. Use this action when you need to: - Decode trade condition codes from options market data - Get the list of all v
- `POST https://api.mcp.ai/api/alpaca/get/options/snapshots/underlying/symbol` — Retrieves the option chain snapshot data for a specific underlying symbol. This endpoint provides the latest trade, quote, and greeks data for all option contracts associated with an underlying symbol
  - body: { feed?: string, type?: string, limit?: integer, page_token?: string, root_symbol?: string, updated_since?: string, expiration_date?: string, strike_price_gte?: number, strike_price_lte?: number, underlying_symbol: string, expiration_date_gte?: string, expiration_date_lte?: string }
- `POST https://api.mcp.ai/api/alpaca/get/pdt/status` — Retrieves the Pattern Day Trader (PDT) status for a specified Alpaca trading account. Use when you need to check if an account is flagged as a PDT, monitor PDT call counts, or verify day trading buyin
  - body: { account_id?: string }
- `POST https://api.mcp.ai/api/alpaca/get/positions/for/account` — Lists all open positions for a specified trading account. Use when you need to retrieve current positions, monitor portfolio holdings, or check unrealized P&L for an account.
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/quotes/for/multiple/stock/symbols` — Retrieves historical quote (bid/ask) data for multiple stock symbols. Use this action when you need historical quote data including bid and ask prices for multiple stock trading symbols. This is usefu
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/quotes/for/stock/symbol` — Retrieves historical NBBO (National Best Bid and Offer) quotes for a specific stock symbol. Use this action when you need historical quote data for a single stock symbol, such as for analysis, backtes
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbol: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/snapshot/for/stock/symbol` — Retrieves a snapshot (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for a single stock symbol. Use this action when you need comprehensive real-time market data for a sing
  - body: { feed?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpaca/get/snapshots/for/multiple/crypto/symbols` — Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols. Use this action when you need comprehensive real-time market data f
  - body: { symbols: string, exchange?: string }
- `POST https://api.mcp.ai/api/alpaca/get/snapshots/for/multiple/stock/symbols` — Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple stock symbols. Use this action when you need comprehensive real-time market data for multip
  - body: { feed?: string, symbols: string }
- `POST https://api.mcp.ai/api/alpaca/get/specific/announcement` — Retrieves a specific corporate action announcement by its unique identifier. Use this action when you need to fetch detailed information about a corporate action such as dividends, stock splits, merge
  - body: { id: string }
- `POST https://api.mcp.ai/api/alpaca/get/stock/auction/single` — Retrieves historical auction (opening/closing print) data for a single stock symbol. Use this action when you need to analyze auction-related price and volume data for a specific stock ticker. This is
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbol: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/stock/auctions` — Retrieves historical auction data for specified stock symbols. Use this action when you need to: - Analyze opening and closing auction prices for stocks - Study pre-market and post-market auction beha
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/stocks/meta/conditions/trade` — Retrieves the mapping of trade condition codes to their names from Alpaca Markets API. Use this action when you need to: - Decode trade condition codes from stock market data - Get the list of all val
  - body: { tape: string }
- `POST https://api.mcp.ai/api/alpaca/get/subscription` — Retrieves a rebalancing subscription by its unique ID. Returns complete subscription details including the associated account ID, portfolio ID, creation timestamp, and last rebalancing timestamp. Use 
  - body: { subscription_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/top/movers/by/market/type` — Retrieves the top market movers (gainers and losers) for a specified market type. Use this action when you need to: - Fetch top gainers and losers for stock market analysis - Get cryptocurrency movers
  - body: { top?: integer, market_type: string }
- `POST https://api.mcp.ai/api/alpaca/get/trades/for/multiple/crypto/symbols` — Retrieves historical trade data for specified crypto symbols. Use when you need to: - Get historical trade data for multiple crypto symbols at once - Analyze trading volume and price movements over ti
  - body: { end?: string, limit?: integer, start?: string, symbols: string, exchanges?: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/trades/for/multiple/stock/symbols` — Retrieves historical trade data for multiple stock symbols. Use this action when you need: - Historical trade data for multiple stock symbols at once - Analyze trading volume and price movements over 
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbols: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/trades/for/stock/symbol` — Retrieves historical trade data for a single stock symbol. Use this action when you need to analyze historical trade data for a specific stock ticker, such as reviewing price movements, trading volume
  - body: { end?: string, feed?: string, limit?: integer, start?: string, symbol: string, page_token?: string }
- `POST https://api.mcp.ai/api/alpaca/get/watchlist/by/id` — Retrieves a single watchlist by its unique identifier. Use when you need to view the details of a specific watchlist, including its name, associated assets, and timestamps. This endpoint provides dire
  - body: { watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/get/watchlist/by/name` — Retrieves a specific watchlist by its name. Use when you need to find a particular watchlist without knowing its ID, such as when managing watchlists for display or modification. Returns the watchlist
  - body: { name: string }
- `POST https://api.mcp.ai/api/alpaca/get/watchlists` — Retrieves all watchlists associated with the authenticated account. Use this action when you need to: - View all watchlists for an account - Find a specific watchlist by name - Check what symbols are 
- `POST https://api.mcp.ai/api/alpaca/patch/account/configurations` — Update the trading account configuration settings for the authenticated account. Use when you need to modify account-level trading settings such as day-trading buying power checks, fractional trading 
  - body: { pdt_check?: string, dtbp_check?: string, no_shorting?: boolean, suspend_trade?: boolean, fractional_trading?: boolean, trade_confirm_email?: string, max_margin_multiplier?: string }
- `POST https://api.mcp.ai/api/alpaca/remove/asset/from/watchlist` — Removes a symbol from an existing watchlist in Alpaca. Use this action when you need to delete a ticker symbol from a watchlist that is no longer being tracked. The action returns the updated watchlis
  - body: { symbol: string, watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/remove/symbol/from/watchlist` — Tool to remove a symbol from an existing watchlist in Alpaca. Use when you need to delete a ticker symbol from a watchlist that is no longer being tracked. This action is irreversible - once a symbol 
  - body: { symbol: string, watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/update/trading/configurations` — Updates trading account configurations for an Alpaca trading account. Use when you need to modify account-level trading settings such as day-trading buying power checks, trade confirmation email prefe
  - body: { frozen?: boolean, account_id?: string, dtbp_check?: string, no_shorting?: boolean, plaid_setting?: string, suspend_trade?: boolean, enable_crypto_send?: boolean, crypto_auto_convert?: boolean, trade_confirm_email?: string }
- `POST https://api.mcp.ai/api/alpaca/update/watchlist/by/id` — Updates an existing watchlist by its unique identifier. Use when you need to modify the name or symbols in a watchlist using its ID rather than name. This action allows partial updates - you can updat
  - body: { name: string, symbols?: string[], watchlist_id: string }
- `POST https://api.mcp.ai/api/alpaca/update/watchlist/by/name` — Updates an existing watchlist by its name. Use when you need to modify the symbols in a watchlist or rename it. The action allows partial updates - you can provide only symbols to update the watchlist
  - body: { name: string, symbols?: string[], new_name?: string }
- `POST https://api.mcp.ai/api/alpaca/update/watchlist/by/name2` — Updates an existing watchlist by its name. Use when you need to modify the symbols in a watchlist or rename it. The action allows partial updates - you can provide only symbols to update the watchlist
  - body: { name: string, symbols?: string[], new_name?: string }
- `POST https://api.mcp.ai/api/alpaca/upload/account/cip` — Upload CIP (Customer Identification Program) information for an account to complete identity verification. Use when you need to submit identity information for a new Alpaca trading account as part of 
  - body: { account_id: string, cip_result: object }

## Example prompts
- "What can I do in Alpaca?"
- "Show me a summary of my Alpaca account"

## More
- Page: https://mcp.ai/alpaca
- Agent spec (llms.txt): https://mcp.ai/alpaca/llms.txt
- Postman collection: https://mcp.ai/alpaca/postman.json