Alpaca MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Alpaca MCP or direct API to check portfolios, place paper trades, fetch market data, and manage orders through natural language.

Alpaca logoAlpaca
Api KeyOauth2

Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.

100 Tools

Try Alpaca now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Alpaca
Try asking
TOOLS

Supported Tools

Every Alpaca action and event your agent gets out of the box.

Add Asset to Watchlist

Adds a symbol to an existing watchlist in the authenticated account.

Add Asset to Watchlist by Name

Add an asset to a watchlist by name.

Create Watchlist

Creates a new watchlist for the authenticated account.

Create Watchlist

Create a new watchlist for the authenticated account.

Delete All Open Positions

Liquidates all open positions by closing them at market price.

Delete All Orders for Account

Attempts to cancel all open orders for a specified trading account.

Delete Unsubscribe Account

Delete a rebalancing subscription to unsubscribe an account.

Delete Watchlist By ID

Delete a watchlist by its unique identifier.

Get Account

Retrieves account information for the authenticated Alpaca account.

Get Account Activities

Retrieves account activities for the authenticated Alpaca account.

Get Account Activities V2

Retrieves account activities of one type for the authenticated Alpaca account using the v2 API.

Get Account Activities By Activity Type

Retrieves account activities of a specific type for the authenticated Alpaca account.

Get Account Configurations

Retrieves the current trading account configuration settings for the authenticated Alpaca account.

Get Account Portfolio History

Retrieves the portfolio history statistics for an Alpaca trading account.

Get Account Portfolio History

Retrieves the portfolio history statistics for a trading account.

Get All Account Positions

Bulk fetches all open positions for the authenticated account.

Get All Open Positions

Retrieves all open positions for the authenticated Alpaca trading account.

Get All Orders

Retrieves all orders for an account based on specified filter criteria.

Get Historical Crypto US Bars

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for crypto symbols in a specific US location.

Get Crypto Bars for Multiple Symbols

Retrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols.

Get Stock Bars for Multiple Symbols

Retrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols.

Get Historical Bars for Stock Symbol

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol.

Get Historical Stock Bars

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol.

Get Calendar

Retrieves market calendar information for trading days from the Alpaca Trading API.

Get Clock

Retrieves the current market clock information from the Alpaca Trading API.

Get Stock Conditions

Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified type (trade or quote conditions) and tape.

Get Crypto Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols at a specific location.

Get Crypto Perp Latest Bars

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols.

Get Crypto Perp Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto perpetual futures symbols.

Get Crypto Perp Latest Pricing

Retrieves the latest pricing data for specified crypto perpetual futures symbols.

Get Crypto Perp Latest Quotes

Retrieves the latest bid and ask prices for specified crypto perpetual futures symbols for a specific location.

Get Crypto Perp Latest Trades

Retrieves the latest trade data for specified crypto perpetual futures symbols.

Get Crypto Perps Global Latest Bars

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols.

Get Crypto Perps Global Latest Pricing

Returns the latest pricing data for crypto perpetual futures symbols.

Get Crypto Perps Global Latest Quotes

Retrieves the latest bid and ask prices for specified crypto perpetual futures symbols.

Get Crypto Perps Global Latest Trades

Retrieves the latest trade data for specified crypto perpetual futures symbols.

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.

Get Crypto US Latest Bars

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for US crypto symbols.

Get Crypto US Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto symbols in the US market.

Get Crypto US Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols in the US location.

Get Crypto US Latest Trades

Retrieves the latest trade data for specified crypto symbols in the US location.

Get Crypto US Historical Quotes

Retrieves historical quote data (bid/ask prices) for specified crypto symbols on US exchanges.

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.

Get Crypto US Trades

Retrieves historical trade data for specified US crypto symbols.

Get Exchanges

Retrieves a list of supported stock exchanges with their short codes and full names from the Alpaca Market Data API.

Get Latest Bar for Stock Symbol

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bar for a single stock symbol.

Get Latest Bars For Crypto Symbol

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bar data for a crypto symbol.

Get Latest Bars for Crypto Symbols

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols.

Get Latest Bars for Multiple Stock Symbols

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols.

Get Crypto Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto symbols.

Get Crypto Latest Quote

Retrieves the latest bid and ask prices for a specified crypto symbol.

Get Latest Quote for Stock Symbol

Retrieves the latest NBBO (National Best Bid and Offer) quote for a single stock symbol.

Get Crypto Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols.

Get Latest Quotes for Multiple Stock Symbols

Retrieves the latest NBBO (National Best Bid and Offer) quotes for multiple stock symbols.

Get Latest Trade for Stock Symbol

Retrieves the latest trade data for a single stock symbol.

Get Latest Crypto Trades

Retrieves the latest trade data for specified crypto symbols.

Get Latest Trades for Multiple Stock Symbols

Retrieves the latest trade data for multiple stock symbols.

Get Market Calendar

Retrieves market calendar information for a specific exchange from the Alpaca Trading API.

Get Meta Exchanges

Retrieves a list of all US stock exchanges and their identifying information from the Alpaca Market Data API.

Get Most Active Stocks

Retrieves the most active stocks by trading volume or trade count.

Get News

Retrieves news articles for specified crypto symbols from the Alpaca Market Data API.

Get Open Position

Fetches a single open position by symbol or asset ID.

Get Options Historical Bars

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for options contracts.

Get Option Chain

Retrieves the option chain for a specific underlying symbol including quotes and greeks for all available strikes and expirations.

Get Option Contract

Get an option contract by its symbol or unique identifier.

Get Option Latest Quotes

Retrieves the latest bid and ask prices for specified option symbols.

Get Options Meta Conditions

Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified tick type (trade or quote conditions).

Get Option Contracts

Retrieve option contracts from Alpaca Markets API (BETA).

Get Options Latest Trades

Retrieves the latest trade for each requested option contract symbol.

Get Options Meta Conditions Trade

Retrieves the mapping of trade condition codes to their names from Alpaca Markets API.

Get Options Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple option contract symbols.

Get Options Snapshots by Underlying Symbol

Retrieves the option chain snapshot data for a specific underlying symbol.

Get Options Historical Trades

Retrieves historical trade data for option contracts.

Get PDT Status

Retrieves the Pattern Day Trader (PDT) status for a specified Alpaca trading account.

List account positions

Lists all open positions for a specified trading account.

Get Quotes for Multiple Stock Symbols

Retrieves historical quote (bid/ask) data for multiple stock symbols.

Get Quotes for Stock Symbol

Retrieves historical NBBO (National Best Bid and Offer) quotes for a specific stock symbol.

Get Stock Snapshot for Symbol

Retrieves a snapshot (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for a single stock symbol.

Get Crypto Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols.

Get Stock Snapshots for Multiple Symbols

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple stock symbols.

Get Specific Announcement

Retrieves a specific corporate action announcement by its unique identifier.

Get Stock Auctions

Retrieves historical auction data for specified stock symbols.

Get Stock Auctions for Symbol

Retrieves historical auction (opening/closing print) data for a single stock symbol.

Get Stocks Meta Conditions Trade

Retrieves the mapping of trade condition codes to their names from Alpaca Markets API.

Get Subscription

Retrieves a rebalancing subscription by its unique ID.

Get Top Movers By Market Type

Retrieves the top market movers (gainers and losers) for a specified market type.

Get Trades for Multiple Crypto Symbols

Retrieves historical trade data for specified crypto symbols.

Get Trades for Multiple Stock Symbols

Retrieves historical trade data for multiple stock symbols.

Get Historical Trades for Stock Symbol

Retrieves historical trade data for a single stock symbol.

Get Watchlist By ID

Retrieves a single watchlist by its unique identifier.

Get Watchlist By Name

Retrieves a specific watchlist by its name.

Get Watchlists

Retrieves all watchlists associated with the authenticated account.

Update Account Configurations

Update the trading account configuration settings for the authenticated account.

Remove Asset From Watchlist

Removes a symbol from an existing watchlist in Alpaca.

Remove Symbol From Watchlist

Tool to remove a symbol from an existing watchlist in Alpaca.

Update Trading Configurations

Updates trading account configurations for an Alpaca trading account.

Update Watchlist By ID

Updates an existing watchlist by its unique identifier.

Update Watchlist By Name

Updates an existing watchlist by its name.

Update Watchlist By Name (v2)

Updates an existing watchlist by its name.

Upload Account CIP Information

Upload CIP (Customer Identification Program) information for an account to complete identity verification.

SETUP GUIDE

Connect Alpaca MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Alpaca
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Show my current Alpaca account balance and open positions'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Alpaca API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Alpaca Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Show my current Alpaca account balance and open positions'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Alpaca actions with your Agent

Why Use Composio?

AI Native Alpaca Integration

  • Supports both Alpaca MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable trading and market data workflows
  • Create MCP access with mcp.create() so agents can use Alpaca tools without custom glue code

Managed Auth

  • Configure Alpaca API key or OAuth access with auth_configs.create()
  • Link each trader or app user with connected_accounts.link() instead of hard-coded keys
  • Central place to manage, scope, and revoke Alpaca access across environments

Agent Optimized Design

  • Tools are tuned for real agent workflows like checking positions, reading market data, and managing orders
  • Clear execution logs help you see what your agent ran, when it ran, and on whose behalf
  • Errors are structured so agents can recover instead of getting stuck

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Alpaca
  • Scoped, least privilege access for trading, account, and market data actions
  • Full audit trail of agent actions to support review, debugging, and compliance
FAQ

Frequently asked questions

Yes, Alpaca requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Alpaca.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Alpaca tool your agent needs.Free to start.

Start building