Alpaca MCP server for AI agents and assistants

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/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["alpaca"],
  mcp: true,
});
Create a session scoped to Alpaca and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Show my current Alpaca account balance and open positions",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Alpaca request
SETUP GUIDE

Connect Alpaca API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["alpaca"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Alpaca
3

Run Alpaca tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Show my current Alpaca account balance and open positions" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Alpaca tool calls through the session, and print the final answer

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
FRAMEWORKS

Use Alpaca with any AI Agent Framework

Choose a Framework you want to connect Alpaca with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Alpaca requires connections to go through your own OAuth app. You register it once with Alpaca, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Alpaca as usual. Composio handles the rest of the flow and the token refresh.

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

Yes. Composio is SOC 2 Type II compliant and is built to keep your Alpaca connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

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

When you connect a Alpaca account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Alpaca as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Alpaca lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Alpaca administrator may need to approve the app first, and you can revoke the access inside Alpaca whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Alpaca connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Alpaca tokens automatically, so day to day you do nothing. If you revoke access inside Alpaca, or Alpaca invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free plan includes 100,000 tool calls per month with no credit card, which covers most personal Alpaca use. Paid plans add higher limits and team features. Your Alpaca plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Alpaca accounts).

With Composio, you connect Alpaca once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Alpaca.It takes 30 seconds.

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

Start building